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

c
ctanh(3M) ctanh(3M)
(Itanium(R)-based System Only)
NAME
ctanh( ), ctanhf( ), ctanhl( ), ctanhw( ), ctanhq( ) - complex hyperbolic tangent functions
SYNOPSIS
#include <complex.h>
double complex ctanh(double complex z);
float complex ctanhf(float complex z);
long double complex ctanhl(long double complex z);
extended complex ctanhw(extended complex z);
quad complex ctanhq(quad complex z);
DESCRIPTION
These functions are available only for Itanium-based systems.
ctanh() returns the complex hyperbolic tangent of z.
ctanhf() is a float complex version of
ctanh(); it takes a float complex argument and
returns a
float complex result.
ctanhl() is a long double complex version of ctanh(); it takes a long double complex
argu-
ment and returns a
long double complex result.
ctanhw() is an extended complex version of ctanh(); it takes an extended complex argument
and returns an extended complex result.
ctanhq() is equivalent to ctanhl() on HP-UX systems.
USAGE
To use these functions, compile with the default
-Ae option. To use ctanhw() or
ctanhq(), compile
with the
-fpwidetypes option. Make sure your program includes <complex.h>. Link in the math
library by specifying -lm on the compiler or linker command line.
RETURN VALUE
ctanh(conj(z)) = conj(ctanh(z)) and ctanh is odd.
ctanh(+0+i0) returns +0+i0.
ctanh(x+iInf) returns NaN+iNaN and raises the invalid floating-point exception, for finite x.
ctanh(x+iNaN) returns NaN+iNaN and optionally raises the invalid floating-point exception, for finite
x.
ctanh(+Inf+iy) returns 1+i0sin(2y), for positive-signed finite y.
ctanh(+Inf+iInf) returns 1±i0 (where the sign of the imaginary part of the result is unspecified).
ctanh(+Inf+iNaN) returns 1±i0 (where the sign of the imaginary part of the result is unspecified).
ctanh(NaN+i0) returns NaN+i0.
ctanh(NaN+iy) returns NaN+iNaN and optionally raises the invalid floating-point exception, for all
nonzero numbers y.
ctanh(NaN+iNaN) returns NaN+iNaN.
ERRORS
No errors are defined.
SEE ALSO
tanh(3M), catanh(3M), complex(5).
STANDARDS CONFORMANCE
ctanh(), ctanhf(), ctanhl() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex
arithmetic’’)
Section 3−−144 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003