all(3I)

NAME
     ALL - Determines whether all values are true

SYNOPSIS
     ALL ([MASK=]mask [,[DIM=]dim])

IMPLEMENTATION
     UNICOS, UNICOS/mk, IRIX systems

     CF90, MIPSpro 7 Fortran 90

STANDARDS
     Fortran

DESCRIPTION
     The ALL intrinsic function determines whether all values are true in
     mask along dimension dim.  It accepts the following arguments:

     mask      Must be of type logical.  It must not be a scalar.

     dim       Must be a scalar.  It must be an integer value in the range
               1 <= dim <= n, where n is the rank of mask.  The
               corresponding actual argument must not be an optional dummy
               argument.

     ALL is a transformational function.  The name of this intrinsic cannot
     be passed as an argument.

RETURN VALUES
     The result is type logical.  It is a scalar result if dim is absent or
     if mask has rank one.  Otherwise, the result is an array of rank n-1
     and of shape (d , d , ..., d     , d     , ..., d ),
                    1   2        dim-1   dim+1        n
     where (d , d , ..., d )
             1   2        n
     is the shape of mask.

     The result of ALL(mask) has the value TRUE if all the elements of mask
     are TRUE or if mask is a zero-sized array.  The result has the value
     FALSE if any element of mask is FALSE.

     If mask has rank one, ALL(mask, dim) has a value equal to that of
     ALL(mask).  Otherwise, the value of
     element (s , s , ..., s     , s     , ..., s )
               1   2        dim-1   dim+1        n
     of ALL(mask, dim) is equal to
     ALL(mask (s , s , ..., s     , : , s     , ..., s )).
                1   2        dim-1       dim+1        n

EXAMPLES
     Example 1:

     * ALL ( (/ .TRUE., .FALSE., .TRUE. /) ) is false.

     * ALL(array) is .TRUE. when array is a zero-sized array.

     Example 2:  Assume that B and C are arrays as follows:

     B is the following array:

     | 1 3 5 |
     | 2 4 6 |

     C is the following array:

     | 0 3 5 |
     | 7 4 8 |

     * ALL ( B .NE. C ) is .FALSE.

     * ALL ( B .NE. C, DIM=1) is [.TRUE., .FALSE., .FALSE.]

     * ALL ( B .NE. C, DIM=2) is [.FALSE., .FALSE.]

     * ALL ( B .NE. 1 ) is .FALSE. because there is one false element in
       the mask.

     Example 3:  Assume that array N is as follows:

     | 0 1 2 3 |
     | 4 5 6 7 |
     | 8 9 0 1 |

     In an array section reference, you can expect the following results:

     * ALL((N(2:3,2:4).NE.0)) is .FALSE.

     * ALL((N(2:3,2:4).NE.0),DIM=1) is [.TRUE., .FALSE., .TRUE.]

     * ALL((N(2:3,2:4).NE.0),DIM=2) is [.TRUE., .FALSE.]

SEE ALSO
     Intrinsic Procedures Reference Manual for the printed version of this
     man page.