anint(3I)

NAME
     ANINT, DNINT, QNINT - Finds nearest whole number

SYNOPSIS
     ANINT ([A=]a [,[KIND=]kind])
     DNINT ([A=]a)
     QNINT ([A=]a)

STANDARDS
     Fortran

     Fortran extension:  QNINT

DESCRIPTION
     ANINT is the generic function name; the others are specifics.  These
     are elemental intrinsic functions.  They accept the following
     arguments:

     a         Must be type single-precision real, double-precision real,
               or quad-precision real.  See the RETURN VALUES section for
               information on input data types and return values.

               The terms single precision, double precision, and quad
               precision differ depending on your platform.  For
               platform-specific information, see the TERMINOLOGY section
               of the INTRO_INTRIN(3I) man page.

     kind      Must be a kind type allowed for a.  This argument is not
               accepted by the MIPSpro Fortran 77 compiler.

NOTES
     The ANINT and DNINT intrinsic function names can be passed as
     arguments; the other cannot.

RETURN VALUES
     ANINT returns the real nearest whole number for its real argument, as
     follows:

     * If a >= 0, the result is REAL(INT(a + 0.5)).

     * If a < 0, the result is REAL(INT(a - 0.5)).

     DNINT returns the double-precision nearest whole number for its
     double-precision argument.

     QNINT returns the quad-precision nearest whole number for its
     quad-precision argument.

EXAMPLES
     The following examples show the results of calling ANINT with positive
     and negative arguments:

     * ANINT(3.7) yields 4.0.

     * ANINT(-3.7) yields -4.0.

SEE ALSO
     AINT(3I)