ieee_unordered(3I)

NAME
     IEEE_UNORDERED - Tests for x or y being a NaN

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

STANDARDS
     Fortran extension

     IEEE Standard for Binary Floating-point Arithmetic

DESCRIPTION
     The IEEE_UNORDERED intrinsic function tests for x or y being a NaN.
     It accepts the following arguments:

     x         Must be of type real.  Can be a scalar or an array.

     y         Must be of type real.  y must be conformable with x.

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

RETURN VALUES
     The result type and type parameter are default logical.  If either x
     or y is an array, the result is an array of the same shape as one of
     the array arguments.

     The return value is .TRUE. if either x or y is a NaN, otherwise the
     return value is .FALSE..  The operation does not raise the Invalid
     Operation interrupt.

     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 has the value .TRUE. or .FALSE., depending on whether xi
     is unordered with y.

     If x is scalar and y is an array, the result is an array in which each
     element has the value .TRUE. or .FALSE., depending on whether x is
     unordered with yi.


     If x is an array and y is an array, the result is an array in which
     each element has the value .TRUE. or .FALSE., depending on whether
     xi is unordered with yi.


EXAMPLES
          REAL   x,y
          ...                       ! Compute X.
          IF (IEEE_UNORDERED(x, y)) THEN
             ...                    ! Do something.
          ELSE
             ...                    ! Do something else.
          END IF