sinhl(3m) - osol9

1sinh(3M)                Mathematical Library Functions                sinh(3M)
2
3
4

NAME

6       sinh, sinhf, sinhl - hyperbolic sine function
7

SYNOPSIS

9       c99 [ flag... ] file... -lm [ library... ]
10       #include <math.h>
11
12       double sinh(double x);
13
14
15       float sinhf(float x);
16
17
18       long double sinhl(long double x);
19
20

DESCRIPTION

22       These functions compute the hyperbolic sine of x.
23

RETURN VALUES

25       Upon  successful completion, these functions return the hyperbolic sine
26       of x.
27
28
29       If the result would  cause  an  overflow,  a  range  error  occurs  and
30       ±HUGE_VAL,  ±HUGE_VALF,  and  ±HUGE_VALL  (with  the same sign as x) is
31       returned as appropriate for the type of the function.
32
33
34       If x is NaN, a NaN is returned.
35
36
37       If x is ±0 or ±Inf, x is returned.
38
39
40       For exceptional cases, matherr(3M) tabulates the values to be  returned
41       by acos() as specified by SVID3 and XPG3.
42

ERRORS

44       These functions will fail if:
45
46       Range Error    The result would cause an overflow.
47
48                      If    the   integer   expression   (math_errhandling   &
49                      MATH_ERREXCEPT) is non-zero, the overflow floating-point
50                      exception is raised.
51
52                      The  asinh() function sets errno to ERANGE if the result
53                      would cause an overflow.
54
55

USAGE

57       An application wanting to check for exceptions should  call  feclearex‐
58       cept(FE_ALL_EXCEPT)  before  calling  these  functions.  On  return, if
59       fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is
60       non-zero,  an  exception  has been raised. An application should either
61       examine the return value or check the floating point exception flags to
62       detect exceptions.
63
64
65       An  application  can  also  set  errno  to 0 before calling asinh(). On
66       return, if errno is non-zero, an error has occurred. The  asinhf()  and
67       asinhl() functions do not set errno.
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Standard                     │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT-Level                     │MT-Safe                      │
81       └─────────────────────────────┴─────────────────────────────┘
82