View source for c/numeric/tgmath

===Complex/real type-generic macros===

For all functions that have both real and complex counterparts, a type-generic macro {{tt|XXX}} exists, which calls either of:
* real function:
:* {{c|float}} variant {{tt|XXXf}}
:* {{c|double}} variant {{tt|XXX}}
:* {{c|long double}} variant {{tt|XXXl}}
* complex function:
:* {{c|float}} variant {{tt|cXXXf}}
:* {{c|double}} variant {{tt|cXXX}}
:* {{c|long double}} variant {{tt|cXXXl}}

An exception to the above rule is the {{tt|fabs}} macro (see the table below).

The function to call is determined as follows:

* If any of the arguments for the generic parameters is imaginary, the behavior is specified on each function reference page individually (in particular, {{tt|sin}}, {{tt|cos}}, {{tt|tag}}, {{tt|cosh}}, {{tt|sinh}}, {{tt|tanh}}, {{tt|asin}}, {{tt|atan}}, {{tt|asinh}}, and {{tt|atanh}} call ''real'' functions, the return types of {{tt|sin}}, {{tt|tan}}, {{tt|sinh}}, {{tt|tanh}}, {{tt|asin}}, {{tt|atan}}, {{tt|asinh}}, and {{tt|atanh}} are imaginary, and the return types of {{tt|cos}} and {{tt|cosh}} are real).
* If any of the arguments for the generic parameters is complex, then the complex function is called, otherwise the real function is called.
* If any of the arguments for the generic parameters is {{c|long double}}, then the {{c|long double}} variant is called. Otherwise, if any of the parameters is {{c|double}} or integer, then the {{c|double}} variant is called. Otherwise, {{c|float}} variant is called.

The type-generic macros are as follows:

{| class="wikitable"
|-
! Type-generic macro
! colspan=3 | Real function <br> variants 
! colspan=3 | Complex function <br> variants
|-
! style="height: 8em;" | &nbsp;
! {{vertical|{{c|float}}}}
! {{vertical|{{c|double}}}} 
! {{vertical|{{c|long double}}}} 
! {{vertical|{{c|float}}}}
! {{vertical|{{c|double}}}} 
! {{vertical|{{c|long double}}}} 
|-
! fabs
| {{ltt|c/numeric/math/fabs|fabsf}}
| {{ltt|c/numeric/math/fabs|fabs}}
| {{ltt|c/numeric/math/fabs|fabsl}}
| {{ltt|c/numeric/complex/cabs|cabsf}}
| {{ltt|c/numeric/complex/cabs|cabs}}
| {{ltt|c/numeric/complex/cabs|cabsl}}
|-
! exp
| {{ltt|c/numeric/math/exp|expf}}
| {{ltt|c/numeric/math/exp|exp}}
| {{ltt|c/numeric/math/exp|expl}}
| {{ltt|c/numeric/complex/cexp|cexpf}}
| {{ltt|c/numeric/complex/cexp|cexp}}
| {{ltt|c/numeric/complex/cexp|cexpl}}
|-
! log
| {{ltt|c/numeric/math/log|logf}}
| {{ltt|c/numeric/math/log|log}}
| {{ltt|c/numeric/math/log|logl}}
| {{ltt|c/numeric/complex/clog|clogf}}
| {{ltt|c/numeric/complex/clog|clog}}
| {{ltt|c/numeric/complex/clog|clogl}}
|-
! pow
| {{ltt|c/numeric/math/pow|powf}}
| {{ltt|c/numeric/math/pow|pow}}
| {{ltt|c/numeric/math/pow|powl}}
| {{ltt|c/numeric/complex/cpow|cpowf}}
| {{ltt|c/numeric/complex/cpow|cpow}}
| {{ltt|c/numeric/complex/cpow|cpowl}}
|-
! sqrt
| {{ltt|c/numeric/math/sqrt|sqrtf}}
| {{ltt|c/numeric/math/sqrt|sqrt}}
| {{ltt|c/numeric/math/sqrt|sqrtl}}
| {{ltt|c/numeric/complex/csqrt|csqrtf}}
| {{ltt|c/numeric/complex/csqrt|csqrt}}
| {{ltt|c/numeric/complex/csqrt|csqrtl}}
|-
! sin
| {{ltt|c/numeric/math/sin|sinf}}
| {{ltt|c/numeric/math/sin|sin}}
| {{ltt|c/numeric/math/sin|sinl}}
| {{ltt|c/numeric/complex/csin|csinf}}
| {{ltt|c/numeric/complex/csin|csin}}
| {{ltt|c/numeric/complex/csin|csinl}}
|-
! cos
| {{ltt|c/numeric/math/cos|cosf}}
| {{ltt|c/numeric/math/cos|cos}}
| {{ltt|c/numeric/math/cos|cosl}}
| {{ltt|c/numeric/complex/ccos|ccosf}}
| {{ltt|c/numeric/complex/ccos|ccos}}
| {{ltt|c/numeric/complex/ccos|ccosl}}
|-
! tan
| {{ltt|c/numeric/math/tan|tanf}}
| {{ltt|c/numeric/math/tan|tan}}
| {{ltt|c/numeric/math/tan|tanl}}
| {{ltt|c/numeric/complex/ctan|ctanf}}
| {{ltt|c/numeric/complex/ctan|ctan}}
| {{ltt|c/numeric/complex/ctan|ctanl}}
|-
! asin
| {{ltt|c/numeric/math/asin|asinf}}
| {{ltt|c/numeric/math/asin|asin}}
| {{ltt|c/numeric/math/asin|asinl}}
| {{ltt|c/numeric/complex/casin|casinf}}
| {{ltt|c/numeric/complex/casin|casin}}
| {{ltt|c/numeric/complex/casin|casinl}}
|-
! acos
| {{ltt|c/numeric/math/acos|acosf}}
| {{ltt|c/numeric/math/acos|acos}}
| {{ltt|c/numeric/math/acos|acosl}}
| {{ltt|c/numeric/complex/cacos|cacosf}}
| {{ltt|c/numeric/complex/cacos|cacos}}
| {{ltt|c/numeric/complex/cacos|cacosl}}
|-
! atan
| {{ltt|c/numeric/math/atan|atanf}}
| {{ltt|c/numeric/math/atan|atan}}
| {{ltt|c/numeric/math/atan|atanl}}
| {{ltt|c/numeric/complex/catan|catanf}}
| {{ltt|c/numeric/complex/catan|catan}}
| {{ltt|c/numeric/complex/catan|catanl}}
|-
! sinh
| {{ltt|c/numeric/math/sinh|sinhf}}
| {{ltt|c/numeric/math/sinh|sinh}}
| {{ltt|c/numeric/math/sinh|sinhl}}
| {{ltt|c/numeric/complex/csinh|csinhf}}
| {{ltt|c/numeric/complex/csinh|csinh}}
| {{ltt|c/numeric/complex/csinh|csinhl}}
|-
! cosh
| {{ltt|c/numeric/math/cosh|coshf}}
| {{ltt|c/numeric/math/cosh|cosh}}
| {{ltt|c/numeric/math/cosh|coshl}}
| {{ltt|c/numeric/complex/ccosh|ccoshf}}
| {{ltt|c/numeric/complex/ccosh|ccosh}}
| {{ltt|c/numeric/complex/ccosh|ccoshl}}
|-
! tanh
| {{ltt|c/numeric/math/tanh|tanhf}}
| {{ltt|c/numeric/math/tanh|tanh}}
| {{ltt|c/numeric/math/tanh|tanhl}}
| {{ltt|c/numeric/complex/ctanh|ctanhf}}
| {{ltt|c/numeric/complex/ctanh|ctanh}}
| {{ltt|c/numeric/complex/ctanh|ctanhl}}
|-
! asinh
| {{ltt|c/numeric/math/asinh|asinhf}}
| {{ltt|c/numeric/math/asinh|asinh}}
| {{ltt|c/numeric/math/asinh|asinhl}}
| {{ltt|c/numeric/complex/casinh|casinhf}}
| {{ltt|c/numeric/complex/casinh|casinh}}
| {{ltt|c/numeric/complex/casinh|casinhl}}
|-
! acosh
| {{ltt|c/numeric/math/acosh|acoshf}}
| {{ltt|c/numeric/math/acosh|acosh}}
| {{ltt|c/numeric/math/acosh|acoshl}}
| {{ltt|c/numeric/complex/cacosh|cacoshf}}
| {{ltt|c/numeric/complex/cacosh|cacosh}}
| {{ltt|c/numeric/complex/cacosh|cacoshl}}
|-
! atanh
| {{ltt|c/numeric/math/atanh|atanhf}}
| {{ltt|c/numeric/math/atanh|atanh}}
| {{ltt|c/numeric/math/atanh|atanhl}}
| {{ltt|c/numeric/complex/catanh|catanhf}}
| {{ltt|c/numeric/complex/catanh|catanh}}
| {{ltt|c/numeric/complex/catanh|catanhl}}
|}