1 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
2 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
3 .\" <mtk.manpages@gmail.com>
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
7 .\" References consulted:
8 .\" Linux libc source code
9 .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
11 .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
12 .\" Modified 1996-06-08 by aeb
13 .\" Modified 2002-07-27 by Walter Harms
14 .\" (walter.harms@informatik.uni-oldenburg.de)
16 .TH COSH 3 2021-03-22 "" "Linux Programmer's Manual"
18 cosh, coshf, coshl \- hyperbolic cosine function
21 .RI ( libm ", " \-lm )
26 .BI "double cosh(double " x );
27 .BI "float coshf(float " x );
28 .BI "long double coshl(long double " x );
32 Feature Test Macro Requirements for glibc (see
33 .BR feature_test_macros (7)):
39 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
40 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
41 || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
44 These functions return the hyperbolic cosine of
46 which is defined mathematically as:
49 cosh(x) = (exp(x) + exp(\-x)) / 2
52 On success, these functions return the hyperbolic cosine of
57 is a NaN, a NaN is returned.
61 is +0 or \-0, 1 is returned.
65 is positive infinity or negative infinity,
66 positive infinity is returned.
68 If the result overflows,
70 and the functions return
79 for information on how to determine whether an error has occurred
80 when calling these functions.
82 The following errors can occur:
84 Range error: result overflow
88 An overflow floating-point exception
92 For an explanation of the terms used in this section, see
100 Interface Attribute Value
105 T} Thread safety MT-Safe
111 C99, POSIX.1-2001, POSIX.1-2008.
113 The variant returning
118 In glibc version 2.3.4 and earlier,
119 an overflow floating-point
121 exception is not raised when an overflow occurs.