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

NAME

6       asinh, asinhf, asinhl - inverse hyperbolic sine functions
7

SYNOPSIS

9       #include <math.h>
10
11       double asinh(double x);
12       float asinhf(float x);
13       long double asinhl(long double x);
14
15

DESCRIPTION

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

RETURN VALUE

27       Upon successful completion, these functions shall  return  the  inverse
28       hyperbolic sine of their argument.
29
30       If x is NaN, a NaN shall be returned.
31
32       If x is ±0, or ±Inf, x shall be returned.
33
34       If x is subnormal, a range error may occur and x should be returned.
35

ERRORS

37       These functions may fail if:
38
39       Range Error
40              The value of x is subnormal.
41
42       If  the integer expression (math_errhandling & MATH_ERRNO) is non-zero,
43       then errno  shall  be  set  to  [ERANGE].  If  the  integer  expression
44       (math_errhandling  &  MATH_ERREXCEPT)  is  non-zero, then the underflow
45       floating-point exception shall be raised.
46
47
48       The following sections are informative.
49

EXAMPLES

51       None.
52

APPLICATION USAGE

54       On  error,  the  expressions  (math_errhandling   &   MATH_ERRNO)   and
55       (math_errhandling  & MATH_ERREXCEPT) are independent of each other, but
56       at least one of them must be non-zero.
57

RATIONALE

59       None.
60

FUTURE DIRECTIONS

62       None.
63

SEE ALSO

65       feclearexcept() , fetestexcept() , sinh() , the Base Definitions volume
66       of  IEEE Std 1003.1-2001,  Section  4.18, Treatment of Error Conditions
67       for Mathematical Functions, <math.h>
68

70       Portions of this text are reprinted and reproduced in  electronic  form
71       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
72       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
73       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
74       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
75       event of any discrepancy between this version and the original IEEE and
76       The Open Group Standard, the original IEEE and The Open Group  Standard
77       is  the  referee document. The original Standard can be obtained online
78       at http://www.opengroup.org/unix/online.html .
79
80
81
82IEEE/The Open Group                  2003                             ASINH(P)
Impressum