Debian Codegraph @

upstream/debian-trixie/man3/sinh.3

raw
1 '\" t
2 .\" Copyright 1993 David Metcalfe ([email protected])
3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
4 .\" <[email protected]>
5 .\"
6 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
7 .\"
8 .\" References consulted:
9 .\" Linux libc source code
10 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
11 .\" 386BSD man pages
12 .\" Modified 1993-07-24 by Rik Faith ([email protected])
13 .\" Modified 1996-06-08 by aeb
14 .\" Modified 2002-07-27 by Walter Harms
15 .\" ([email protected])
16 .\"
17 .TH sinh 3 2024-05-02 "Linux man-pages 6.9.1"
18 .SH NAME
19 sinh, sinhf, sinhl \- hyperbolic sine function
20 .SH LIBRARY
21 Math library
22 .RI ( libm ", " \-lm )
23 .SH SYNOPSIS
24 .nf
25 .B #include <math.h>
26 .P
27 .BI "double sinh(double " x );
28 .BI "float sinhf(float " x );
29 .BI "long double sinhl(long double " x );
30 .fi
31 .P
32 .RS -4
33 Feature Test Macro Requirements for glibc (see
34 .BR feature_test_macros (7)):
35 .RE
36 .P
37 .BR sinhf (),
38 .BR sinhl ():
39 .nf
40 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
41 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
42 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
43 .fi
44 .SH DESCRIPTION
45 These functions return the hyperbolic sine of
46 .IR x ,
47 which
48 is defined mathematically as:
49 .P
50 .nf
51 sinh(x) = (exp(x) \- exp(\-x)) / 2
52 .fi
53 .SH RETURN VALUE
54 On success, these functions return the hyperbolic sine of
55 .IR x .
56 .P
57 If
58 .I x
59 is a NaN, a NaN is returned.
60 .P
61 If
62 .I x
63 is +0 (\-0), +0 (\-0) is returned.
64 .P
65 If
66 .I x
67 is positive infinity (negative infinity),
68 positive infinity (negative infinity) is returned.
69 .P
70 If the result overflows,
71 a range error occurs,
72 and the functions return
73 .BR HUGE_VAL ,
74 .BR HUGE_VALF ,
75 or
76 .BR HUGE_VALL ,
77 respectively, with the same sign as
78 .IR x .
79 .\"
80 .\" POSIX.1-2001 documents an optional range error (underflow)
81 .\" for subnormal x;
82 .\" glibc 2.8 does not do this.
83 .SH ERRORS
84 See
85 .BR math_error (7)
86 for information on how to determine whether an error has occurred
87 when calling these functions.
88 .P
89 The following errors can occur:
90 .TP
91 Range error: result overflow
92 .I errno
93 is set to
94 .BR ERANGE .
95 An overflow floating-point exception
96 .RB ( FE_OVERFLOW )
97 is raised.
98 .SH ATTRIBUTES
99 For an explanation of the terms used in this section, see
100 .BR attributes (7).
101 .TS
102 allbox;
103 lbx lb lb
104 l l l.
105 Interface Attribute Value
106 T{
107 .na
108 .nh
109 .BR sinh (),
110 .BR sinhf (),
111 .BR sinhl ()
112 T} Thread safety MT-Safe
113 .TE
114 .SH STANDARDS
115 C11, POSIX.1-2008.
116 .SH HISTORY
117 C99, POSIX.1-2001.
118 .P
119 The variant returning
120 .I double
121 also conforms to
122 SVr4, 4.3BSD, C89.
123 .SH SEE ALSO
124 .BR acosh (3),
125 .BR asinh (3),
126 .BR atanh (3),
127 .BR cosh (3),
128 .BR csinh (3),
129 .BR tanh (3)