|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
PROLOG | NAME | SYNOPSIS | DESCRIPTION | APPLICATION USAGE | RATIONALE | FUTURE DIRECTIONS | SEE ALSO | COPYRIGHT |
|
|
|
math.h(0P) POSIX Programmer's Manual math.h(0P)
This manual page is part of the POSIX Programmer's Manual. The
Linux implementation of this interface may differ (consult the
corresponding Linux manual page for details of Linux behavior),
or the interface may not be implemented on Linux.
math.h — mathematical declarations
#include <math.h>
Some of the functionality described on this reference page
extends the ISO C standard. Applications shall define the
appropriate feature test macro (see the System Interfaces volume
of POSIX.1‐2017, Section 2.2, The Compilation Environment) to
enable the visibility of these symbols in this header.
The <math.h> header shall define at least the following types:
float_t A real-floating type at least as wide as float.
double_t A real-floating type at least as wide as double, and
at least as wide as float_t.
If FLT_EVAL_METHOD equals 0, float_t and double_t shall be float
and double, respectively; if FLT_EVAL_METHOD equals 1, they shall
both be double; if FLT_EVAL_METHOD equals 2, they shall both be
long double; for other values of FLT_EVAL_METHOD, they are
otherwise implementation-defined.
The <math.h> header shall define the following macros, where
real-floating indicates that the argument shall be an expression
of real-floating type:
int fpclassify(real-floating x);
int isfinite(real-floating x);
int isgreater(real-floating x, real-floating y);
int isgreaterequal(real-floating x, real-floating y);
int isinf(real-floating x);
int isless(real-floating x, real-floating y);
int islessequal(real-floating x, real-floating y);
int islessgreater(real-floating x, real-floating y);
int isnan(real-floating x);
int isnormal(real-floating x);
int isunordered(real-floating x, real-floating y);
int signbit(real-floating x);
The <math.h> header shall define the following symbolic
constants. The values shall have type double and shall be
accurate to at least the precision of the double type.
M_E Value of e
M_LOG2E Value of log_2 e
M_LOG10E Value of log_10 e
M_LN2 Value of log_e 2
M_LN10 Value of log_e 10
M_PI Value of π
M_PI_2 Value of π/2
M_PI_4 Value of π/4
M_1_PI Value of 1/π
M_2_PI Value of 2/π
M_2_SQRTPI Value of 2/√‾π
M_SQRT2 Value of √‾2
M_SQRT1_2 Value of 1/√‾2
The <math.h> header shall define the following symbolic constant:
MAXFLOAT Same value as FLT_MAX in <float.h>.
The <math.h> header shall define the following macros:
HUGE_VAL A positive double constant expression, not
necessarily representable as a float. Used as an
error value returned by the mathematics library.
HUGE_VAL evaluates to +infinity on systems supporting
IEEE Std 754‐1985.
HUGE_VALF A positive float constant expression. Used as an
error value returned by the mathematics library.
HUGE_VALF evaluates to +infinity on systems
supporting IEEE Std 754‐1985.
HUGE_VALL A positive long double constant expression. Used as
an error value returned by the mathematics library.
HUGE_VALL evaluates to +infinity on systems
supporting IEEE Std 754‐1985.
INFINITY A constant expression of type float representing
positive or unsigned infinity, if available; else a
positive constant of type float that overflows at
translation time.
NAN A constant expression of type float representing a
quiet NaN. This macro is only defined if the
implementation supports quiet NaNs for the float
type.
The following macros shall be defined for number classification.
They represent the mutually-exclusive kinds of floating-point
values. They expand to integer constant expressions with distinct
values. Additional implementation-defined floating-point
classifications, with macro definitions beginning with FP_ and an
uppercase letter, may also be specified by the implementation.
FP_INFINITE FP_NAN FP_NORMAL FP_SUBNORMAL FP_ZERO
The following optional macros indicate whether the fma() family
of functions are fast compared with direct code:
FP_FAST_FMA FP_FAST_FMAF FP_FAST_FMAL
If defined, the FP_FAST_FMA macro shall expand to the integer
constant 1 and shall indicate that the fma() function generally
executes about as fast as, or faster than, a multiply and an add
of double operands. If undefined, the speed of execution is
unspecified. The other macros have the equivalent meaning for the
float and long double versions.
The following macros shall expand to integer constant expressions
whose values are returned by ilogb(x) if x is zero or NaN,
respectively. The value of FP_ILOGB0 shall be either {INT_MIN} or
-{INT_MAX}. The value of FP_ILOGBNAN shall be either {INT_MAX}
or {INT_MIN}.
FP_ILOGB0 FP_ILOGBNAN
The following macros shall expand to the integer constants 1 and
2, respectively;
MATH_ERRNO MATH_ERREXCEPT
The following macro shall expand to an expression that has type
int and the value MATH_ERRNO, MATH_ERREXCEPT, or the bitwise-
inclusive OR of both:
math_errhandling
The value of math_errhandling is constant for the duration of the
program. It is unspecified whether math_errhandling is a macro or
an identifier with external linkage. If a macro definition is
suppressed or a program defines an identifier with the name
math_errhandling , the behavior is undefined. If the expression
(math_errhandling & MATH_ERREXCEPT) can be non-zero, the
implementation shall define the macros FE_DIVBYZERO, FE_INVALID,
and FE_OVERFLOW in <fenv.h>.
The following shall be declared as functions and may also be
defined as macros. Function prototypes shall be provided.
double acos(double);
float acosf(float);
double acosh(double);
float acoshf(float);
long double acoshl(long double);
long double acosl(long double);
double asin(double);
float asinf(float);
double asinh(double);
float asinhf(float);
long double asinhl(long double);
long double asinl(long double);
double atan(double);
double atan2(double, double);
float atan2f(float, float);
long double atan2l(long double, long double);
float atanf(float);
double atanh(double);
float atanhf(float);
long double atanhl(long double);
long double atanl(long double);
double cbrt(double);
float cbrtf(float);
long double cbrtl(long double);
double ceil(double);
float ceilf(float);
long double ceill(long double);
double copysign(double, double);
float copysignf(float, float);
long double copysignl(long double, long double);
double cos(double);
float cosf(float);
double cosh(double);
float coshf(float);
long double coshl(long double);
long double cosl(long double);
double erf(double);
double erfc(double);
float erfcf(float);
long double erfcl(long double);
float erff(float);
long double erfl(long double);
double exp(double);
double exp2(double);
float exp2f(float);
long double exp2l(long double);
float expf(float);
long double expl(long double);
double expm1(double);
float expm1f(float);
long double expm1l(long double);
double fabs(double);
float fabsf(float);
long double fabsl(long double);
double fdim(double, double);
float fdimf(float, float);
long double fdiml(long double, long double);
double floor(double);
float floorf(float);
long double floorl(long double);
double fma(double, double, double);
float fmaf(float, float, float);
long double fmal(long double, long double, long double);
double fmax(double, double);
float fmaxf(float, float);
long double fmaxl(long double, long double);
double fmin(double, double);
float fminf(float, float);
long double fminl(long double, long double);
double fmod(double, double);
float fmodf(float, float);
long double fmodl(long double, long double);
double frexp(double, int *);
float frexpf(float, int *);
long double frexpl(long double, int *);
double hypot(double, double);
float hypotf(float, float);
long double hypotl(long double, long double);
int ilogb(double);
int ilogbf(float);
int ilogbl(long double);
double j0(double);
double j1(double);
double jn(int, double);
double ldexp(double, int);
float ldexpf(float, int);
long double ldexpl(long double, int);
double lgamma(double);
float lgammaf(float);
long double lgammal(long double);
long long llrint(double);
long long llrintf(float);
long long llrintl(long double);
long long llround(double);
long long llroundf(float);
long long llroundl(long double);
double log(double);
double log10(double);
float log10f(float);
long double log10l(long double);
double log1p(double);
float log1pf(float);
long double log1pl(long double);
double log2(double);
float log2f(float);
long double log2l(long double);
double logb(double);
float logbf(float);
long double logbl(long double);
float logf(float);
long double logl(long double);
long lrint(double);
long lrintf(float);
long lrintl(long double);
long lround(double);
long lroundf(float);
long lroundl(long double);
double modf(double, double *);
float modff(float, float *);
long double modfl(long double, long double *);
double nan(const char *);
float nanf(const char *);
long double nanl(const char *);
double nearbyint(double);
float nearbyintf(float);
long double nearbyintl(long double);
double nextafter(double, double);
float nextafterf(float, float);
long double nextafterl(long double, long double);
double nexttoward(double, long double);
float nexttowardf(float, long double);
long double nexttowardl(long double, long double);
double pow(double, double);
float powf(float, float);
long double powl(long double, long double);
double remainder(double, double);
float remainderf(float, float);
long double remainderl(long double, long double);
double remquo(double, double, int *);
float remquof(float, float, int *);
long double remquol(long double, long double, int *);
double rint(double);
float rintf(float);
long double rintl(long double);
double round(double);
float roundf(float);
long double roundl(long double);
double scalbln(double, long);
float scalblnf(float, long);
long double scalblnl(long double, long);
double scalbn(double, int);
float scalbnf(float, int);
long double scalbnl(long double, int);
double sin(double);
float sinf(float);
double sinh(double);
float sinhf(float);
long double sinhl(long double);
long double sinl(long double);
double sqrt(double);
float sqrtf(float);
long double sqrtl(long double);
double tan(double);
float tanf(float);
double tanh(double);
float tanhf(float);
long double tanhl(long double);
long double tanl(long double);
double tgamma(double);
float tgammaf(float);
long double tgammal(long double);
double trunc(double);
float truncf(float);
long double truncl(long double);
double y0(double);
double y1(double);
double yn(int, double);
The following external variable shall be defined:
extern int signgam;
The behavior of each of the functions defined in <math.h> is
specified in the System Interfaces volume of POSIX.1‐2017 for all
representable values of its input arguments, except where stated
otherwise. Each function shall execute as if it were a single
operation without generating any externally visible exceptional
conditions.
The following sections are informative.
The FP_CONTRACT pragma can be used to allow (if the state is on)
or disallow (if the state is off) the implementation to contract
expressions. Each pragma can occur either outside external
declarations or preceding all explicit declarations and
statements inside a compound statement. When outside external
declarations, the pragma takes effect from its occurrence until
another FP_CONTRACT pragma is encountered, or until the end of
the translation unit. When inside a compound statement, the
pragma takes effect from its occurrence until another FP_CONTRACT
pragma is encountered (including within a nested compound
statement), or until the end of the compound statement; at the
end of a compound statement the state for the pragma is restored
to its condition just before the compound statement. If this
pragma is used in any other context, the behavior is undefined.
The default state (on or off) for the pragma is implementation-
defined.
Applications should use FLT_MAX as described in the <float.h>
header instead of the obsolescent MAXFLOAT.
Note that if FLT_EVAL_METHOD is neither 0 nor 1, then some
constants might not compare equal as expected; for example,
(double)M_PI == M_PI can fail.
Before the ISO/IEC 9899:1999 standard, the math library was
defined only for the floating type double. All the names formed
by appending 'f' or 'l' to a name in <math.h> were reserved to
allow for the definition of float and long double libraries; and
the ISO/IEC 9899:1999 standard provides for all three versions of
math functions.
The functions ecvt(), fcvt(), and gcvt() have been dropped from
the ISO C standard since their capability is available through
sprintf().
None.
float.h(0p), stddef.h(0p), sys_types.h(0p)
The System Interfaces volume of POSIX.1‐2017, Section 2.2, The
Compilation Environment, acos(3p), acosh(3p), asin(3p),
asinh(3p), atan(3p), atan2(3p), atanh(3p), cbrt(3p), ceil(3p),
copysign(3p), cos(3p), cosh(3p), erf(3p), erfc(3p), exp(3p),
exp2(3p), expm1(3p), fabs(3p), fdim(3p), floor(3p), fma(3p),
fmax(3p), fmin(3p), fmod(3p), fpclassify(3p), frexp(3p),
hypot(3p), ilogb(3p), isfinite(3p), isgreater(3p),
isgreaterequal(3p), isinf(3p), isless(3p), islessequal(3p),
islessgreater(3p), isnan(3p), isnormal(3p), isunordered(3p),
j0(3p), ldexp(3p), lgamma(3p), llrint(3p), llround(3p), log(3p),
log10(3p), log1p(3p), log2(3p), logb(3p), lrint(3p), lround(3p),
modf(3p), nan(3p), nearbyint(3p), nextafter(3p), pow(3p),
remainder(3p), remquo(3p), rint(3p), round(3p), scalbln(3p),
signbit(3p), sin(3p), sinh(3p), sqrt(3p), tan(3p), tanh(3p),
tgamma(3p), trunc(3p), y0(3p)
Portions of this text are reprinted and reproduced in electronic
form from IEEE Std 1003.1-2017, Standard for Information
Technology -- Portable Operating System Interface (POSIX), The
Open Group Base Specifications Issue 7, 2018 Edition, Copyright
(C) 2018 by the Institute of Electrical and Electronics
Engineers, Inc and The Open Group. In the event of any
discrepancy between this version and the original IEEE and The
Open Group Standard, the original IEEE and The Open Group
Standard is the referee document. The original Standard can be
obtained online at http://www.opengroup.org/unix/online.html .
Any typographical or formatting errors that appear in this page
are most likely to have been introduced during the conversion of
the source files to man page format. To report such errors, see
https://www.kernel.org/doc/man-pages/reporting_bugs.html .
IEEE/The Open Group 2017 math.h(0P)
Pages that refer to this page: float.h(0p), stdlib.h(0p), tgmath.h(0p), acos(3p), acosh(3p), asin(3p), asinh(3p), atan2(3p), atan(3p), atanh(3p), cbrt(3p), ceil(3p), copysign(3p), cos(3p), cosh(3p), double_t(3type), erf(3p), erfc(3p), exp2(3p), exp(3p), expm1(3p), fabs(3p), fdim(3p), floor(3p), fma(3p), fmax(3p), fmin(3p), fmod(3p), fpclassify(3p), frexp(3p), hypot(3p), ilogb(3p), isfinite(3p), isgreater(3p), isgreaterequal(3p), isinf(3p), isless(3p), islessequal(3p), islessgreater(3p), isnan(3p), isnormal(3p), isunordered(3p), j0(3p), ldexp(3p), lgamma(3p), llrint(3p), llround(3p), log10(3p), log1p(3p), log2(3p), log(3p), logb(3p), lrint(3p), lround(3p), modf(3p), nan(3p), nearbyint(3p), nextafter(3p), pow(3p), remainder(3p), remquo(3p), rint(3p), round(3p), scalbln(3p), signbit(3p), sin(3p), sinh(3p), sqrt(3p), tan(3p), tanh(3p), tgamma(3p), trunc(3p), y0(3p)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|