Name
nextup, nextupf, nextupl, nextdown, nextdownf, nextdownl - return next floating-point number toward positive/negative infinityLibrary
Math library ( libm ", " -lm )Synopsis
"#define(7)_GNU_SOURCE" " /* See feature_test_macros */" #include <math.h> double nextup(double x );
float nextupf(float x );
long double nextupl(long double x );
double nextdown(double x );
float nextdownf(float x );
long double nextdownl(long double x );
Description
The nextup() nextupf() and nextupl() functions return the next representable floating-point number greater thanx
. If x is the smallest representable negative number in the corresponding type, these functions return -0. If x is 0, the returned value is the smallest representable positive number of the corresponding type.
If x is positive infinity, the returned value is positive infinity. If x is negative infinity, the returned value is the largest representable finite negative number of the corresponding type.
If x is Nan, the returned value is NaN.
The value returned by nextdown(x) is -nextup(-x)
, and similarly for the other types.
Return Value
See DESCRIPTION.Attributes
For an explanation of the terms used in this section, see attributes(7).Interface | Attribute | Value |
T} | Thread safety | MT-Safe |
Standards
These functions are described in IEEE Std 754-2008 - Standard for Floating-Point Arithmetic and"ISO/IEC TS 18661".