HPlogo HP-UX Reference > S

sinh(3M)

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

Technical documentation

 » Table of Contents

 » Index

NAME

sinh(), sinhf(), sinhl(), sinhw(), sinhq() — hyperbolic sine functions

SYNOPSIS

#include <math.h>

double sinh(double x);

float sinhf(float x);

Itanium(R)-based System Only

long double sinhl(long double x);

extended sinhw(extended x);

quad sinhq(quad x);

DESCRIPTION

sinh() returns the hyperbolic sine of x.

sinhf() is a float version of sinh(); it takes a float argument and returns a float result.

Itanium-based System Only

sinhl() is a long double version of sinh(); it takes a long double argument and returns a long double result.

sinhw() is an extended version of sinh(); it takes an extended argument and returns an extended result.

sinhq() is equivalent to sinhl() on HP-UX systems.

USAGE

To use these functions, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options.

To use (for Itanium-based systems) sinhw() or sinhq(), 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

sinh(±0) returns ±0.

If x is ±INFINITY, sinh() returns ±INFINITY respectively.

If x is NaN, sinh() returns NaN.

sinh() returns a properly signed 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 sinh() raises the inexact exception is unspecified.

ERRORS

If the correct value would overflow, sinh() 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

sinh() : SVID3, XPG4.2, ANSI C, ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')

sinhf(), sinhl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')