HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

181

182

183

184

185

186

187

188

189

190

cosh(3M) cosh(3M)

NAME

cosh( ), coshf( ), coshl( ), coshw( ), coshq( ) - hyperbolic cosine functions

SYNOPSIS

#include <math.h>

double cosh(double x);

float coshf(float x);

Itanium(R)-based System 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.

Itanium-based System 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 Itanium-based systems)

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.

RETURN VALUE

cosh(±0) returns 1.

If x is ±INFINITY,

cosh() returns +INFINITY.

If x is NaN,

cosh() returns NaN.

cosh() returns inﬁnity (equal to HUGE_VAL) in lieu of a value whose magnitude is too large, and raise

the overﬂow and inexact exceptions.

When it raises no other exception, whether

cosh() raises the inexact exception is unspeciﬁed.

ERRORS

If the correct value would overﬂow,

cosh() sets errno to [ERANGE].

Itanium-based System Only

HP-UX

libm functions on Itanium-based systems do not set errno by default. For errno setting, com-

pile with the +Olibmerrno option.