NAME

nearbyint — round to integral value in floating-point format

SYNOPSIS

#include <math.h>

double
nearbyint(double x);

long double
nearbyintl(long double x);

float
nearbyintf(float x);

DESCRIPTION

The nearbyint() functions return the integral value (represented as a double precision number) nearest to x according to the prevailing rounding mode.

nearbyint() is the same as rint(), except that nearbyint is guaranteed never to set floating point flags or trigger floating point exceptions (which are disabled by default). rint() is typically much more performant than nearbyint() if the application does not depend on flags being preserved.

SPECIAL VALUES

nearbyint(±0) returns ±0 for all rounding modes.

nearbyint(±infinity) returns ±infinity for all rounding modes.

SEE ALSO

rint(3) ceil(3) floor(3) round(3) trunc(3) lround(3) lrint(3) llround(3) llrint(3) math(3)

STANDARDS

The nearbyint() functions conform to ISO/IEC 9899:2011.