catanh-catanhf-catanhl.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: catanh, catanhf, catanhl	catanh, catanhf, catanhl	11/04/2016	catanh catanhf catanhl	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-math-l1-1-0.dll	DLLExport	apiref	catanh catanhf catanhl complex/catanh complex/catanhf complex/catanhl	catanh function catanhf function catanhl function	1b6021cb-647a-41b4-9d7f-919cc8b57b86

catanh, catanhf, catanhl

Retrieves the inverse hyperbolic tangent of a complex number, with branch cuts outside the interval [-1; +1] along the real axis.

Syntax

_Dcomplex catanh(
   _Dcomplex z
);
_Fcomplex catanh(
   _Fcomplex z
);  // C++ only
_Lcomplex catanh(
   _Lcomplex z
);  //  C++ only
_Fcomplex catanhf(
   _Fcomplex z
);
_Lcomplex catanhl(
   _Lcomplex z
);

Parameters

z
A complex number that represents an angle, in radians.

Return value

The inverse hyperbolic tangent of z, in radians. The result is unbounded along the real axis, and in the interval [-iπ/2; +iπ/2] along the imaginary axis. A domain error will occur if z is outside the interval [-1, +1]. A pole error will occur if z is -1 or +1.

Remarks

Because C++ allows overloading, you can call overloads of catanh that take and return _Fcomplex and _Lcomplex values. In a C program, catanh always takes and returns a _Dcomplex value.

Requirements

Routine	C header	C++ header
catanh, catanhf, catanhl	<complex.h>	<ccomplex>

For more compatibility information, see Compatibility.

See also

Alphabetical function reference
ctanh, ctanhf, ctanhl
catan, catanf, catanl
csinh, csinhf, csinhl
casinh, casinhf, casinhl
ccosh, ccoshf, ccoshl
cacosh, cacoshf, cacoshl
cacos, cacosf, cacosl
ctan, ctanf, ctanl
csin, csinf, csinl
casin, casinf, casinl
ccos, ccosf, ccosl
csqrt, csqrtf, csqrtl