RINT 3CW "09 March 2006" "mathcw-1.00"

Table of contents


NAME

rintf, rint, rintl, rintw, rintq, rintll, rintdf, rintd, rintdl, rintdll - round-to-nearest integral value using current rounding direction

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

extern float rintf (float x);

extern double rint (double x);

extern long double rintl (long double x);

extern __float80 rintw (__float80 x);

extern __float128 rintq (__float128 x);

extern long_long_double rintll (long_long_double x);

extern decimal_float rintdf (decimal_float x);

extern decimal_double rintd (decimal_double x);

extern decimal_long_double rintdl (decimal_long_double x);

extern decimal_long_long_double rintdll (decimal_long_long_double x);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Compute the whole number nearest x in the direction of the current IEEE 754 rounding mode.

Caution: Depending on the argument size and precision, the result may be too large to store in a variable of some integer type, even though it is exactly representable as a floating-point value.


RETURN VALUES

For finite nonzero arguments, the returned value is the requisite whole number. For Infinity, NaN, and zero arguments, the returned value is the argument.

ERRORS

None.

SEE ALSO

ceil(3CW), floor(3CW), llrint(3CW), llround(3CW), lrint(3CW), lround(3CW), modf(3CW), nearbyint(3CW), round(3CW), trunc(3CW).