Debian Codegraph @

upstream/debian-unstable/man3/asinh.3

raw
1 '\" t
2 .\" Copyright 1993, David Metcalfe <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH asinh 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 asinh, asinhf, asinhl \- inverse hyperbolic sine function
10 .SH LIBRARY
11 Math library
12 .RI ( libm ,\~ \-lm )
13 .SH SYNOPSIS
14 .nf
15 .B #include <math.h>
16 .P
17 .BI "double asinh(double " x );
18 .BI "float asinhf(float " x );
19 .BI "long double asinhl(long double " x );
20 .fi
21 .P
22 .RS -4
23 Feature Test Macro Requirements for glibc (see
24 .BR feature_test_macros (7)):
25 .RE
26 .P
27 .BR asinh ():
28 .nf
29 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
30 || _XOPEN_SOURCE >= 500
31 .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
32 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
33 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
34 .fi
35 .P
36 .BR asinhf (),
37 .BR asinhl ():
38 .nf
39 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
40 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
41 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
42 .fi
43 .SH DESCRIPTION
44 These functions calculate the inverse hyperbolic sine of
45 .IR x ;
46 that is the value whose hyperbolic sine is
47 .IR x .
48 .SH RETURN VALUE
49 On success, these functions return the inverse hyperbolic sine of
50 .IR x .
51 .P
52 If
53 .I x
54 is a NaN, a NaN is returned.
55 .P
56 If
57 .I x
58 is +0 (\-0), +0 (\-0) is returned.
59 .P
60 If
61 .I x
62 is positive infinity (negative infinity),
63 positive infinity (negative infinity) is returned.
64 .\"
65 .\" POSIX.1-2001 documents an optional range error for subnormal x;
66 .\" glibc 2.8 does not do this.
67 .SH ERRORS
68 No errors occur.
69 .SH ATTRIBUTES
70 For an explanation of the terms used in this section, see
71 .BR attributes (7).
72 .TS
73 allbox;
74 lbx lb lb
75 l l l.
76 Interface Attribute Value
77 T{
78 .na
79 .nh
80 .BR asinh (),
81 .BR asinhf (),
82 .BR asinhl ()
83 T} Thread safety MT-Safe
84 .TE
85 .SH STANDARDS
86 C11, POSIX.1-2008.
87 .SH HISTORY
88 C99, POSIX.1-2001.
89 .P
90 The variant returning
91 .I double
92 also conforms to
93 SVr4, 4.3BSD.
94 .SH SEE ALSO
95 .BR acosh (3),
96 .BR atanh (3),
97 .BR casinh (3),
98 .BR cosh (3),
99 .BR sinh (3),
100 .BR tanh (3)