ieee_remainder(3I)

NAME
     IEEE_REMAINDER - Returns the remainder of x divided by y

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

STANDARDS
     Fortran extension

     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(3I) 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.

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
       xi divided by y.


     * 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
       yi.


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


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

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

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