NAME
cosh(), coshf(), coshl(), coshw(), coshq() — hyperbolic cosine functions
SYNOPSIS
#include <math.h>
double cosh(double x);
float coshf(float x);
HP Integrity Server Only
long double coshl(long double x);
extended coshw(extended x);
quad coshq(quad x);
DESCRIPTION
cosh()
returns the hyperbolic cosine of
x.
coshf()
is a
float
version of
cosh();
it takes a
float
argument and returns a
float
result.
Integrity Server Only
coshl()
is a
long double
version of
cosh();
it takes a
long double
argument and returns a
long double
result.
coshw()
is an
extended
version of
cosh();
it takes an
extended
argument and returns an
extended
result.
coshq()
is equivalent to
coshl()
on HP-UX systems.
USAGE
To use these functions compile either with the default
-Ae
option or with the
-Aa
and the
-D_HPUX_SOURCE
options.
To use (for Integrity servers)
coshw()
or
coshq(),
compile also with the
-fpwidetypes
option.
To use any of these functions, make sure your program includes
<math.h>,
and link in the math library by specifying
-lm
on the compiler or linker command line.
For more information, see the
HP-UX floating-point guide for HP Integrity servers
at the following site:
http://www.hp.com/go/fp.
RETURN VALUE
cosh(±0)
returns 1.
If
x
is ±INFINITY,
cosh()
returns +INFINITY.
If
x
is NaN,
cosh()
returns NaN.
cosh()
returns infinity
(equal to
HUGE_VAL)
in lieu of a value whose magnitude is too large, and raise
the overflow and inexact exceptions.
When it raises no other exception,
whether
cosh()
raises the
inexact exception is unspecified.
ERRORS
If the correct value would overflow,
cosh()
sets
errno
to [ERANGE].
Integrity Server Only
HP-UX
libm
functions on Integrity servers do not set
errno
by default. For
errno
setting, compile with the
+Olibmerrno
option.
STANDARDS CONFORMANCE
cosh()
: SVID3, XPG4.2, ANSI C, ISO/IEC C99
(including Annex F, ``IEC 60559 floating-point arithmetic'')
coshf(),
coshl()
: ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')
Printable version
