NAME
tgmath —
type-generic macros
SYNOPSIS
#include <tgmath.h>
DESCRIPTION
The header
<tgmath.h> provides
type-generic macros for
<math.h> and
<complex.h> functions that have
float (suffixed with
f),
double, and
long double (suffixed
with
l) versions. The arguments that vary across the three
functions and have type
float,
double, and
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
long
double or
long double complex, the
long double function is called. Else, if any generic
argument has type
double,
double
complex, or an integer type, the
double version is
invoked. Otherwise, the macro expands to the
float
implementation.
For the macros in the following table, both real and complex functions exist.
The real functions are prototyped in
<math.h> and the complex equivalents
in
<complex.h>. The complex function
is called if any of the generic arguments is a complex value. Otherwise, the
real equivalent is called.
No complex functions exist for the following macros, so passing a complex value
to a generic argument invokes undefined behaviour:
The following macros always expand to a complex function:
This header includes
<complex.h> and
<math.h>.
STANDARDS
The header
<tgmath.h> conforms to
ISO/IEC 9899:1999 (“ISO C99”).
AUTHORS
Matt Thomas
<
matt@3am-software.com>
BUGS
The header
<tgmath.h> cannot be
implemented with strictly conforming C code and needs special compiler
support. The current implementation only works for GCC.
Many of the functions mentioned here are not prototyped in
<math.h> or
<complex.h> as they are not yet
implemented.