1SINH(P)                    POSIX Programmer's Manual                   SINH(P)
2
3
4

NAME

6       sinh, sinhf, sinhl - hyperbolic sine functions
7

SYNOPSIS

9       #include <math.h>
10
11       double sinh(double x);
12       float sinhf(float x);
13       long double sinhl(long double x);
14
15

DESCRIPTION

17       These functions shall compute the hyperbolic sine of their argument x.
18
19       An  application  wishing to check for error situations should set errno
20       to zero and  call  feclearexcept(FE_ALL_EXCEPT)  before  calling  these
21       functions.   On return, if errno is non-zero or fetestexcept(FE_INVALID
22       | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) is non-zero, an error  has
23       occurred.
24

RETURN VALUE

26       Upon successful completion, these functions shall return the hyperbolic
27       sine of x.
28
29       If the result would cause an overflow, a range error  shall  occur  and
30       ±HUGE_VAL,  ±HUGE_VALF,  and ±HUGE_VALL (with the same sign as x) shall
31       be returned as appropriate for the type of the function.
32
33       If x is NaN, a NaN shall be returned.
34
35       If x is ±0 or ±Inf, x shall be returned.
36
37       If x is subnormal, a range error may occur and x should be returned.
38

ERRORS

40       These functions shall fail if:
41
42       Range Error
43              The result would cause an overflow.
44
45       If the integer expression (math_errhandling & MATH_ERRNO) is  non-zero,
46       then  errno  shall  be  set  to  [ERANGE].  If  the  integer expression
47       (math_errhandling & MATH_ERREXCEPT)  is  non-zero,  then  the  overflow
48       floating-point exception shall be raised.
49
50
51       These functions may fail if:
52
53       Range Error
54              The value x is subnormal.
55
56       If  the integer expression (math_errhandling & MATH_ERRNO) is non-zero,
57       then errno  shall  be  set  to  [ERANGE].  If  the  integer  expression
58       (math_errhandling  &  MATH_ERREXCEPT)  is  non-zero, then the underflow
59       floating-point exception shall be raised.
60
61
62       The following sections are informative.
63

EXAMPLES

65       None.
66

APPLICATION USAGE

68       On  error,  the  expressions  (math_errhandling   &   MATH_ERRNO)   and
69       (math_errhandling  & MATH_ERREXCEPT) are independent of each other, but
70       at least one of them must be non-zero.
71

RATIONALE

73       None.
74

FUTURE DIRECTIONS

76       None.
77

SEE ALSO

79       asinh() , cosh() , feclearexcept() , fetestexcept() , isnan() ,  tanh()
80       ,  the  Base  Definitions volume of IEEE Std 1003.1-2001, Section 4.18,
81       Treatment of Error Conditions for Mathematical Functions, <math.h>
82

84       Portions of this text are reprinted and reproduced in  electronic  form
85       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
86       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
87       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
88       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
89       event of any discrepancy between this version and the original IEEE and
90       The Open Group Standard, the original IEEE and The Open Group  Standard
91       is  the  referee document. The original Standard can be obtained online
92       at http://www.opengroup.org/unix/online.html .
93
94
95
96IEEE/The Open Group                  2003                              SINH(P)
Impressum