[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

sinh, sinhf, or sinhl Subroutine

Purpose

Computes hyperbolic sine.

Syntax

#include <math.h>


double sinh ( x)
double x;

float sinhf (x)
float x;

long double sinhl (x)
double x;

Description

The sinh, sinhf, and sinhl subroutines compute the hyperbolic sine of the x parameter.

An application wishing to check for error situations should set the errno global variable to zero and call feclearexcept(FE_ALL_EXCEPT) before calling these subroutines. Upon return, if errno is nonzero or fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is nonzero, an error has occurred.

Parameters

x Specifies a double-precision floating-point value.

Return Values

Upon successful completion, the sinh, sinhf, and sinhl subroutines return the hyperbolic sine of x.

If the result would cause an overflow, a range error occurs and ±HUGE_VAL, ±HUGE_VALF, and ±HUGE_VALL (with the same sign as x) is returned as appropriate for the type of the function.

If x is NaN, a NaN is returned.

If x is ±0 orInf, x is returned.

If x is subnormal, a range error may occur and x should be returned.

Error Codes

If the correct value overflows, the sinh, sinhf and sinhl subroutines return a correctly signed HUGE_VAL, and the errno global variable is set to ERANGE.

These error-handling procedures should be changed with the matherr subroutine when the libmsaa.a (-lmsaa) library is used.

Related Information

asinh, acosh, or atanh Subroutine , feclearexcept Subroutine, fetestexcept Subroutine, and class, _class, finite, isnan, or unordered Subroutines in AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions Volume 1.

math.h in AIX 5L Version 5.2 Files Reference.

The matherr subroutine, sin, asin, acos, atan, or atan2 (sin, sinf, or sinl Subroutine) subroutine.

Subroutines Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

128-Bit long double Floating-Point Format in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]