.\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
.\" <mtk.manpages@gmail.com>
.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\" Linux libc source code
.\" Modified 2002-07-27 by Walter Harms
.\" (walter.harms@informatik.uni-oldenburg.de)
.\"
-.TH COSH 3 2015-03-02 "" "Linux Programmer's Manual"
+.TH COSH 3 2021-03-22 "Linux man-pages (unreleased)"
.SH NAME
cosh, coshf, coshl \- hyperbolic cosine function
+.SH LIBRARY
+Math library
+.RI ( libm ", " \-lm )
.SH SYNOPSIS
.nf
.B #include <math.h>
-.sp
+.PP
.BI "double cosh(double " x );
-.br
.BI "float coshf(float " x );
-.br
.BI "long double coshl(long double " x );
.fi
-.sp
-Link with \fI\-lm\fP.
-.sp
-.in -4n
+.PP
+.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
-.in
-.sp
-.ad l
+.RE
+.PP
.BR coshf (),
.BR coshl ():
-.RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
-.br
-or
-.I cc\ -std=c99
-.RE
-.ad
-.SH DESCRIPTION
-The
-.BR cosh ()
-function returns the hyperbolic cosine of
-.IR x ,
-which
-is defined mathematically as:
.nf
-
- cosh(x) = (exp(x) + exp(\-x)) / 2
+ _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
+ || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+ || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
+.SH DESCRIPTION
+These functions return the hyperbolic cosine of
+.IR x ,
+which is defined mathematically as:
+.PP
+.in +4n
+.EX
+cosh(x) = (exp(x) + exp(\-x)) / 2
+.EE
+.in
.SH RETURN VALUE
On success, these functions return the hyperbolic cosine of
.IR x .
-
+.PP
If
.I x
is a NaN, a NaN is returned.
-
+.PP
If
.I x
is +0 or \-0, 1 is returned.
-
+.PP
If
.I x
is positive infinity or negative infinity,
positive infinity is returned.
-
+.PP
If the result overflows,
a range error occurs,
and the functions return
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
+.ad l
+.nh
.TS
allbox;
-lbw24 lb lb
+lbx lb lb
l l l.
Interface Attribute Value
T{
.BR coshl ()
T} Thread safety MT-Safe
.TE
-.SH CONFORMING TO
+.hy
+.ad
+.sp 1
+.SH STANDARDS
C99, POSIX.1-2001, POSIX.1-2008.
-
+.PP
The variant returning
.I double
also conforms to