This manual page is for Mac OS X version 10.6.3

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



ROUND(3)                                BSD Library Functions Manual                                ROUND(3)

NAME
     round, lround, llround -- round to integral value, regardless of rounding direction

SYNOPSIS
     #include <math.h>

     double
     round(double x);

     long double
     roundl(long double x);

     float
     roundf(float x);

     long int
     lround(double x);

     long int
     lroundl(long double x);

     long int
     lroundf(float x);

     long long int
     llround(double x);

     long long int
     llroundl(long double x);

     long long int
     llroundf(float x);

DESCRIPTION
     The round() functions return the integral value nearest to x rounding half-way cases away from zero,
     regardless of the current rounding direction.

     The lround() and llround() functions return the integral value nearest to x (rounding half-way cases
     away from zero, regardless of the current rounding direction) in the return formats specified.  If the
     rounded value is outside the range of the return type, the numeric result is unspecified and the
     "invalid" floating-point exception is raised. A range error may occur if the magnitude of x is too
     large.

SPECIAL VALUES
     round(+-_) returns +-0.

     round(+-infinity) returns +-infinity.

     The round() functions may, but are not required to, raise the "inexact" floating-point exception for
     non-integer numeric arguments.

     The lround() and llround() functions need not raise the "inexact" floating-point exception for non-integer noninteger
     integer arguments that round to within the range of the return type.

NOTE
     The roundtol() function is deprecated.  Please use the C99 function lround() instead.

SEE ALSO
     abs(3), fabs(3), ceil(3), floor(3), math(3), rint(3)

STANDARDS
     The round() , lround() , and llround() functions conform to ISO/IEC 9899:1999(E).

BSD                                             July 02, 2008                                            BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...