rintl(3)

rintl3

Round to integral value in floating-point format

Part of rint(3).

Usage

#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);

Library

Math Library (libm, -lm)

Overview

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.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 26 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3–14.5
  27. 15.0–16.0

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.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.