ieee_remainder(3I)

NAME
     IEEE_REMAINDER - Returns the remainder of x divided by y

SYNOPSIS
     IEEE_REMAINDER ([X=]x, [Y=]y)

IMPLEMENTATION
     UNICOS/mk and IRIX systems

     CRAY T90 systems that support IEEE floating-point arithmetic

STANDARDS
     CF90 and MIPSpro 7 Fortran 90 compiler extension to Fortran 90

     IEEE Standard for Binary Floating-point Arithmetic

DESCRIPTION
     The IEEE_REMAINDER intrinsic function returns the remainder of the
     operation x divided by y.  Note that this function does not have
     precisely the same definition as either of the Fortran 90 intrinsic
     functions MOD(3M) or MODULO(3I).

     The IEEE_REMAINDER function accepts the following arguments:

     x         Must be of type real.  It can be scalar or an array.

     y         Must be of type real.  If x is scalar, y can be scalar or an
               array.  If x is an array, y can be scalar or an array of the
               same shape as x.

     IEEE_REMAINDER is an elemental function.  The name of this intrinsic
     cannot be passed as an argument.

NOTES
     The IEEE intrinsic procedures use the named constants contained in a
     system module, so you must include one of the following statements in
     your program:

     * On UNICOS and UNICOS/mk systems:  USE CRI_IEEE_DEFINITIONS

     * On UNICOS, UNICOS/mk, and IRIX systems:  USE FTN_IEEE_DEFINITIONS

     The CRI_IEEE_DEFINITIONS module is obsolescent.  It will be removed
     for the CF90 4.0 release.

RETURN VALUES
     The same type and kind type parameter as the argument of the largest
     precision and range.  For example, if x is type REAL(KIND=4) and y is
     type REAL(KIND=8), the result is of type REAL(KIND=8).  If either x or
     y is an array, the result is an array of the same shape as one of the
     array arguments.

     The form of the result value is determined as follows:

     * If x and y are both scalar, the result is a scalar.

     * If x is an array and y is scalar, the result is an array in which
       each element is the remainder of
       x  divided by y.
        i

     * If x is scalar and y is an array, the result is an array in which
       each element is the remainder of x divided by
       y .
        i

     * If x is an array and y is an array, the result is an array in which
       each element is the remainder of
       x  divided by y .
        i             i

EXAMPLES
          REAL  x, y, r
          ...                     ! Compute X and Y.
          r = IEEE_REMAINDER(x, y)

          IF (r /= 0.0) THEN
             ...
          END IF

SEE ALSO
     MOD(3M) MODULO(3I)

     Intrinsic Procedures Reference Manual, publication SR-2138, for the
     printed version of this man page.