HPlogo HP-UX Reference > A

asinh(3M)

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

Technical documentation

 » Table of Contents

 » Index

NAME

asinh(), asinhf(), asinhl(), asinhw(), asinhq() — arc hyperbolic sine functions

SYNOPSIS

#include <math.h>

double asinh(double x);

Itanium(R)-based System Only

float asinhf(float x);

long double asinhl(long double x);

extended asinhw(extended x);

quad asinhq(quad x);

DESCRIPTION

asinh() returns the arc hyperbolic sine of x.

Itanium-based System Only

asinhf() is a float version of asinh(); it takes a float argument and returns a float result.

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

asinhw() is an extended version of asinh(); it takes an extended argument and returns an extended result.

asinhq() is equivalent to asinhl() on HP-UX systems.

USAGE

To use (for Itanium-based systems) asinhf(), asinhl(), asinhw(), or asinhq(), compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options.

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

asinh(±0) returns ±0.

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

If x is NaN, asinh() returns NaN.

Whether asinh() raises the inexact exception is unspecified.

ERRORS

No errors are defined.

STANDARDS CONFORMANCE

asinh(), asinhf(), asinhl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')