nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl - floating-point number manipulation
#include <math.h>
double nextafter(double x
, double y
);
float nextafterf(float x
, float y
);
long double nextafterl(long double x
, long double y
);
double nexttoward(double x
, long double y
);
float nexttowardf(float x
, long double y
);
long double nexttowardl(long double x
, long double y
);
Link with -lm
.
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
The nextafter(), nextafterf(), and nextafterl() functions return the next representable floating-point value following x
in the direction of y
. If y
is less than x
, these functions will return the largest representable number less than x
.
If x
equals y
, the functions return y
.
The nexttoward(), nexttowardf(), and nexttowardl() functions do the same as the corresponding nextafter() functions, except that they have a long double
second argument.
On success, these functions return the next representable floating-point value after x
in the direction of y
.
If x
equals y
, then y
(cast to the same type as x
) is returned.
If x
or y
is a NaN, a NaN is returned.
If x
is finite, and the result would overflow, a range error occurs, and the functions return HUGE_VAL, HUGE_VALF, or HUGE_VALL, respectively, with the correct mathematical sign.
If x
is not equal to y
, and the correct function result would be subnormal, zero, or underflow, a range error occurs, and either the correct value (if it can be represented), or 0.0, is returned.
nearbyint(3)