HPlogo HP-UX Reference > C

cosh(3M)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

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 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].

Itanium-based System Only

HP-UX libm functions on Itanium-based systems 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'')