Path: utzoo!utgpu!news-server.csri.toronto.edu!mailrus!wuarchive!zaphod.mps.ohio-state.edu!sdd.hp.com!elroy.jpl.nasa.gov!ames!dftsrv!hq!lgn!spoffojj
From: spoffojj@hq.af.mil (Jason Spofford)
Newsgroups: comp.sys.amiga.tech
Subject: Re: Help needed from UNIX buff
Message-ID: <spoffojj.650040393@lgn>
Date: 7 Aug 90 14:46:33 GMT
References: <10936@wehi.dn.mu.oz>
Sender: news@hq.af.mil
Lines: 94

In <10936@wehi.dn.mu.oz> BAXTER_A@wehi.dn.mu.oz writes:
>I am currently porting (I hope) HPGLtoPS and was wondering:

>What does the UNIX C function rint() do?

Here is the man page on rint() - I couldn't mail directly so everyone
else may want to skip the rest of this mail note.

RINT(3M)              MATHEMATICAL LIBRARY               RINT(3M)

NAME
     aint, anint, ceil, floor,  rint,  irint,  nint  -  round  to
     integral value in floating-point or integer format

SYNOPSIS
     #include <math.h>

     double aint(x)
     double x;

     double anint(x)
     double x;

     double ceil(x)
     double x;

     double floor(x)
     double x;

     double rint(x)
     double x;

     int irint(x)
     double x;

     int nint(x)
     double x;

DESCRIPTION
     aint, anint, ceil, floor, and rint() convert a double  value
     into  an  integral value in double format.  They vary in how
     they choose the result when the argument is not  already  an
     integral  value.   Here an integral value means a value of a
     mathematical integer, which however might be  too  large  to
     fit in a particular computer's int format.  All sufficiently
     large values  in  a  particular  floating-point  format  are
     already  integral;  in  IEEE  double-precision  format, that
     means all values >= 2**52.   Zeros,  infinities,  and  quiet
     NaNs  are  treated  as  integral  values by these functions,
     which always preserve their argument's sign.

     aint() returns the integral value between _x and  0,  nearest
     _x.  This corresponds to IEEE rounding toward zero and to the
     Fortran generic intrinsic function aint.

     anint() returns the nearest  integral  value  to  _x,  except
     halfway  cases  are  rounded to the integral value larger in
     magnitude.  This corresponds to the Fortran generic  intrin-
     sic function anint.

     ceil() returns the least  integral  value  greater  than  or
     equal  to  _x.   This  corresponds  to  IEEE  rounding toward

Sun Release 4.0   Last change: 15 October 1987                  1

RINT(3M)              MATHEMATICAL LIBRARY               RINT(3M)

     positive infinity.

     floor() returns the greatest integral  value  less  than  or
     equal  to _x.  This corresponds to IEEE rounding toward nega-
     tive infinity.

     rint() rounds _x  to  an  integral  value  according  to  the
     current IEEE rounding direction.

     irint converts _x into int format according  to  the  current
     IEEE rounding direction.

     nint() converts _x into int format rounding  to  the  nearest
     int value, except halfway cases are rounded to the int value
     larger in magnitude.  This corresponds to the  Fortran  gen-
     eric intrinsic function nint.

Sun Release 4.0   Last change: 15 October 1987                  2




--
----------------------------------------------------------
)   Jason Spofford        The LAN Manager                (
)   spoffojj.hq.af.mil    George Mason Univ. Grad. Stud. (
----------------------------------------------------------