GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TGMATH (3)

NAME

tgmath - type-generic macros

CONTENTS

Synopsis
Description
Standards
History
Compiler Support
Bugs

SYNOPSIS


.In tgmath.h

DESCRIPTION

The header
.In tgmath.h provides type-generic macros for
.In math.h and
.In complex.h functions that have
.Vt float (suffixed with f),
.Vt double and
.Vt long double (suffixed with l) versions. The arguments that vary across the three functions and have type
.Vt float , double and
.Vt long double , respectively, are called generic arguments.

The following rules describe which function is actually called if a type-generic macro is invoked. If any generic argument has type
.Vt long double or
.Vt long double complex , the
.Vt long double function is called. Else, if any generic argument has type
.Vt double , double complex or an integer type, the
.Vt double version is invoked. Otherwise, the macro expands to the
.Vt float implementation.

For the macros in the following table, both real and complex functions exist. The real functions are prototyped in
.In math.h and the complex equivalents in
.In complex.h . The complex function is called if any of the generic arguments is a complex value. Otherwise, the real equivalent is called.
Macro      real function      complex function
acos      acos      cacos
asin      asin      casin
atan      atan      catan
acosh      acosh      cacosh
asinh      asinh      casinh
atanh      atanh      catanh
cos      cos      ccos
sin      sin      csin
tan      tan      ctan
cosh      cosh      ccosh
sinh      sinh      csinh
tanh      tanh      ctanh
exp      exp      cexp
log      log      clog
pow      pow      cpow
sqrt      sqrt      csqrt
fabs      fabs      cabs
 

No complex functions exist for the following macros, so passing a complex value to a generic argument invokes undefined behaviour:
atan2      fma      llround      remainder
cbrt      fmax      log10      remquo
ceil      fmin      log1p      rint
copysign      fmod      log2      round
erf      frexp      logb      scalbn
erfc      hypot      lrint      scalbln
exp2      ilogb      lround      tgamma
expm1      ldexp      nextbyint      trunc
fdim      lgamma      nextafter     
floor      llrint      nexttoward     
 

The following macros always expand to a complex function:
carg      cimag      conj      cproj      creal

This header includes
.In complex.h and
.In math.h .

STANDARDS

The header
.In tgmath.h conforms to -isoC-99.

HISTORY

The header
.In tgmath.h first appeared in
.Fx 5.3 .

COMPILER SUPPORT

Before -isoC-2011, the header
.In tgmath.h could not be implemented with strictly conforming C code and needed special compiler support. As of -isoC-2011, this header file can be implemented using the _Generic language keyword. In addition to compilers that support this keyword, this header file works with GCC.

BUGS

Many of the functions mentioned here are not prototyped in
.In math.h or
.In complex.h as they are not yet implemented. This prevents the corresponding type-generic macro from working at all.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.