Debian Codegraph @

upstream/debian-unstable/man3/sinh.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 sinh 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 sinh, sinhf, sinhl \- 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 sinh(double " x );
18 .BI "float sinhf(float " x );
19 .BI "long double sinhl(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 sinhf (),
28 .BR sinhl ():
29 .nf
30 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
31 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
32 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
33 .fi
34 .SH DESCRIPTION
35 These functions return the hyperbolic sine of
36 .IR x ,
37 which
38 is defined mathematically as:
39 .P
40 .nf
41 sinh(x) = (exp(x) \- exp(\-x)) / 2
42 .fi
43 .SH RETURN VALUE
44 On success, these functions return the hyperbolic sine of
45 .IR x .
46 .P
47 If
48 .I x
49 is a NaN, a NaN is returned.
50 .P
51 If
52 .I x
53 is +0 (\-0), +0 (\-0) is returned.
54 .P
55 If
56 .I x
57 is positive infinity (negative infinity),
58 positive infinity (negative infinity) is returned.
59 .P
60 If the result overflows,
61 a range error occurs,
62 and the functions return
63 .BR HUGE_VAL ,
64 .BR HUGE_VALF ,
65 or
66 .BR HUGE_VALL ,
67 respectively, with the same sign as
68 .IR x .
69 .\"
70 .\" POSIX.1-2001 documents an optional range error (underflow)
71 .\" for subnormal x;
72 .\" glibc 2.8 does not do this.
73 .SH ERRORS
74 See
75 .BR math_error (7)
76 for information on how to determine whether an error has occurred
77 when calling these functions.
78 .P
79 The following errors can occur:
80 .TP
81 Range error: result overflow
82 .I errno
83 is set to
84 .BR ERANGE .
85 An overflow floating-point exception
86 .RB ( FE_OVERFLOW )
87 is raised.
88 .SH ATTRIBUTES
89 For an explanation of the terms used in this section, see
90 .BR attributes (7).
91 .TS
92 allbox;
93 lbx lb lb
94 l l l.
95 Interface Attribute Value
96 T{
97 .na
98 .nh
99 .BR sinh (),
100 .BR sinhf (),
101 .BR sinhl ()
102 T} Thread safety MT-Safe
103 .TE
104 .SH STANDARDS
105 C11, POSIX.1-2008.
106 .SH HISTORY
107 C99, POSIX.1-2001.
108 .P
109 The variant returning
110 .I double
111 also conforms to
112 SVr4, 4.3BSD, C89.
113 .SH SEE ALSO
114 .BR acosh (3),
115 .BR asinh (3),
116 .BR atanh (3),
117 .BR cosh (3),
118 .BR csinh (3),
119 .BR tanh (3)