.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
-.TH RINT 3 2015-03-02 "" "Linux Programmer's Manual"
+.TH RINT 3 2017-09-15 "" "Linux Programmer's Manual"
.SH NAME
nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round
to nearest integer
.SH SYNOPSIS
.nf
.B #include <math.h>
-.sp
+.PP
.BI "double nearbyint(double " x );
-.br
.BI "float nearbyintf(float " x );
-.br
.BI "long double nearbyintl(long double " x );
-.sp
+.PP
.BI "double rint(double " x );
-.br
.BI "float rintf(float " x );
-.br
.BI "long double rintl(long double " x );
.fi
-.sp
+.PP
Link with \fI\-lm\fP.
-.sp
+.PP
.in -4n
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.in
-.sp
+.PP
.ad l
.BR nearbyint (),
.BR nearbyintf (),
.BR nearbyintl ():
.RS 4
-_XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L || _ISOC99_SOURCE;
-.br
-or
-.I cc\ -std=c99
+_POSIX_C_SOURCE\ >=\ 200112L || _ISOC99_SOURCE
.RE
.br
.BR rint ():
.RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
-.br
-or
-.I cc\ -std=c99
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+ || _XOPEN_SOURCE\ >=\ 500
+.\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+ || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+ || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.RE
.br
.BR rintf (),
.BR rintl ():
.RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
-.br
-or
-.I cc\ -std=c99
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+ || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+ || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.RE
.ad b
.SH DESCRIPTION
.BR fesetround (3))
and without raising the
.I inexact
-exception. When the current rounding direction is to nearest, these
+exception.
+When the current rounding direction is to nearest, these
functions round halfway cases to the even integer in accordance with
IEEE-754.
-.LP
+.PP
The
.BR rint (),
.BR rintf (),
when the result differs in value from the argument.
.SH RETURN VALUE
These functions return the rounded integer value.
-
+.PP
If
.I x
is integral, +0, \-0, NaN, or infinite,
For the IEEE-754 standard 32-bit and 64-bit floating-point numbers
the maximum value of the exponent is 128 (respectively, 1024),
and the number of mantissa bits is 24 (respectively, 53).)
-
+.PP
If you want to store the rounded value in an integer type,
you probably want to use one of the functions described in
.BR lrint (3)