Reference

nearbyint(3)

round to integral value in floating-point format

NAME

nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl – round to integral value in floating-point format

LIBRARY

Math Library (libm, -lm)

SYNOPSIS

#include <math.h>

double

nearbyint(double x);

float

nearbyintf(float x);

long double

nearbyintl(long double x);

double

rint(double x);

float

rintf(float x);

long double

rintl(long double x);

DESCRIPTION

The rint(), rintf(), and rintl() functions return the integral value nearest to x according to the prevailing rounding mode. These functions raise an inexact exception when the original argument is not an exact integer.

The nearbyint(), nearbyintf(), and nearbyintl() functions perform the same operation, except that they do not raise an inexact exception.

SEE ALSO

abs(3), ceil(3), fabs(3), fenv(3), floor(3), ieee(3), lrint(3), lround(3), math(3), round(3)

STANDARDS

These functions conform to ISO/IEC 9899:1999 (“ISO C99”).

HISTORY

A rint() function appeared in Version 6 AT&T UNIX. The nearbyint() and nearbyintf() functions appeared in FreeBSD 5.3, and the long double variants were first available in FreeBSD 8.0.

History