Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX 11i Version 1.5 Reference Volume 4, Section 3: Libraries > a

acosh(3M)

» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

acosh(), acoshf(), acoshl(), acoshw(), acoshq() — arc hyperbolic cosine functions

SYNOPSIS

#include <math.h>

double acosh(double x);

IA-64 ONLY:

float acoshf(float x);

long double acoshl(long double x);

extended acoshw(extended x);

quad acoshq(quad x);

DESCRIPTION

acosh() returns the arc hyperbolic cosine of x , in the range +zero to +INFINITY.

IA-64 ONLY:

acoshf() is a float version of acosh(); it takes a float argument and returns a float result.

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

acoshw() is an extended version of acosh(); it takes an extended argument and returns an extended result.

acoshq() is equivalent to acoshl() on HP-UX systems.

USAGE

To use (for IA-64 systems) acoshf(), acoshl(), acoshw(), or acoshq(), compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options.

To use (for IA-64 systems) acoshw() or acoshq(), 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

acosh(1) returns +0.

If x < 1.0, acosh() returns NaN and raises the invalid exception.

If x is +INFINITY, acosh() returns +INFINITY.

If x is NaN, acosh() returns NaN.

When it raises no other exception, whether acosh() raises the inexact exception is unspecified.

ERRORS

If x < 1.0, acosh() sets errno to [EDOM].

IA-64 ONLY

HPUX libm functions on IA-64 do not set errno by default. For errno setting, compile with the +Olibmerrno option.

STANDARDS CONFORMANCE

acosh(), acoshf(), acoshl() : ISO/IEC C99 (including Annex F, ``IEC 60559 floating-point arithmetic'')

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2001 Hewlett-Packard Development Company, L.P.