rint(), rintf()

Round to the nearest integral value

Synopsis:

#include <math.h>

double rint ( double x );

float rintf ( float x );

Library:

libm

Description:

The rint() and rintf() functions return the integral value nearest x in the direction of the current rounding mode.

If the current rounding mode rounds toward negative infinity, then rint() is identical to floor(). If the current rounding mode rounds toward positive infinity, then rint() is identical to ceil().

Returns:

An integer (represented as a double precision number) nearest x in the direction of the current rounding mode (IEEE754).

Errors:

No errors will occur.

Examples:

#include <stdio.h>
#include <errno.h>
#include <inttypes.h>
#include <math.h>
#include <fpstatus.h>

int main(int argc, char** argv)
{
    double a, b;

    a = 0.7 ;
    b = rint(a);
    printf("Round Native mode %f -> %f \n", a, b);

    return(0);
}

Classification:

rint() is standard Unix; rintf() is ANSI (draft)

See also:

ceil(), floor()