.\" Copyright (c) 2006 Apple Computer .\" .Dd December 11, 2006 .Dt CATANH 3 .Os BSD 4 .Sh NAME .Nm catanh .Nd complex inverse hyperbolic tangent function .Sh SYNOPSIS .Ft double complex .Fn catanh "double complex z" .Ft long double complex .Fn catanhl "long double complex z" .Ft float complex .Fn catanhf "float complex z" .Sh DESCRIPTION .Fn catanh "z" computes the inverse hyperbolic tangent of the complex floating-point number .Fa z , with branch cuts outside the interval .Bq -1, 1 along the real axis. .Pp .Fn catanh returns values in a strip of the complex plane with imaginary part in the interval .Bq -Pi/2 , Pi/2 . .Pp For all complex floating point numbers z, .Bd -literal -offset indent catanh(conj(z)) = conj(catanh(z)). catanh(-z) = -catanh(z) .Ed .Sh SPECIAL VALUES The symmetries of catanh() are used to abbreviate the specification of special values. .Pp .Fn catanh "0 + 0i" returns 0 + 0 i. .Pp .Fn catanh "0 + NaN i" returns 0 + NaN i. .Pp .Fn catanh "1 + 0i" returns inf + 0i and raises the divide-by-zero flag. .Pp .Fn catanh "x + inf i" returns 0 + Pi/2 i, for finite positive-signed x. .Pp .Fn catanh "x + NaN i" returns NaN + NaN i, for non-zero finite x. .Pp .Fn catanh "inf + yi" returns 0 + Pi/2 i, for finite positive-signed y. .Pp .Fn catanh "inf + inf i" returns 0 + Pi/2 i. .Pp .Fn catanh "inf + NaN i" returns 0 + NaN i. .Pp .Fn catanh "NaN + yi" returns NaN + NaN i, for finite y. .Pp .Fn catanh "NaN + inf i" returns 0 + Pi/2 i. .Pp .Fn catanh "NaN + NaN i" returns NaN + NaN i. .Sh NOTES .Sh SEE ALSO .Xr ctanh 3 .Xr complex 3 .Sh STANDARDS The .Fn catanh function conforms to ISO/IEC 9899:1999(E).