Movatterモバイル変換

rint(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|ATTRIBUTES \|STANDARDS \|HISTORY \|SEE ALSO \|COLOPHON

rint(3)                  Library Functions Manualrint(3)

NAME top

       nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - round to       nearest integer

LIBRARY top

       Math library (libm,-lm)

SYNOPSIS top

#include <math.h>double nearbyint(doublex);float nearbyintf(floatx);long double nearbyintl(long doublex);double rint(doublex);float rintf(floatx);long double rintl(long doublex);   Feature Test Macro Requirements for glibc (seefeature_test_macros(7)):nearbyint(),nearbyintf(),nearbyintl():           _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCErint():           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L               || _XOPEN_SOURCE >= 500               || /* Since glibc 2.19: */ _DEFAULT_SOURCE               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCErintf(),rintl():           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L               || /* Since glibc 2.19: */ _DEFAULT_SOURCE               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION top

       Thenearbyint(),nearbyintf(), andnearbyintl() functions round       their argument to an integer value in floating-point format, using       the current rounding direction (seefesetround(3)) and without       raising theinexact exception.  When the current rounding       direction is to nearest, these functions round halfway cases to       the even integer in accordance with IEEE-754.       Therint(),rintf(), andrintl() functions do the same, but will       raise theinexact exception (FE_INEXACT, checkable viafetestexcept(3)) when the result differs in value from the       argument.

RETURN VALUE top

       These functions return the rounded integer value.       Ifx is integral, +0, -0, NaN, or infinite,x itself is returned.

ERRORS top

       No errors occur.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │nearbyint(),nearbyintf(),           │ Thread safety │ MT-Safe │       │nearbyintl(),rint(),rintf(),       │               │         │       │rintl()                              │               │         │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       C11, POSIX.1-2008.

HISTORY top

       C99, POSIX.1-2001.       SUSv2 and POSIX.1-2001 contain text about overflow (which might       seterrno toERANGE, or raise anFE_OVERFLOWexception).  In       practice, the result cannot overflow on any current machine, so       this error-handling stuff was just nonsense.  (More precisely,       overflow can happen only when the maximum value of the exponent is       smaller than the number of mantissa bits.  For the IEEE-754       standard 32-bit and 64-bit floating-point numbers the maximum       value of the exponent is 127 (respectively, 1023), and the number       of mantissa bits including the implicit bit is 24 (respectively,       53).)  This was removed in POSIX.1-2008.       If you want to store the rounded value in an integer type, you       probably want to use one of the functions described inlrint(3)       instead.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17rint(3)

Pages that refer to this page:abs(3), ceil(3), fabs(3), floor(3), lrint(3), lround(3), nextafter(3), nextup(3), round(3), roundup(3), trunc(3)