| Description: | Determines if all values are true in an entire array or in a specified dimension of an array. | ||
| Class: | Transformational function; Generic | ||
| Arguments: | MASK | Must be a logical array. | |
| DIM (opt) | Must be a scalar integer with a value in the range 1 to n, where n is the rank of MASK. | ||
| Results: | The result is an array or a scalar of type
logical.
The result is a scalar if DIM is omitted or MASK has rank one. A scalar result is true only if all elements of MASK are true, or MASK has size zero. The result has the value false if any element of MASK is false. An array result has the same type and kind parameters as MASK, and a rank that is one less than MASK. Its shape is (d1, d2, ..., dDIM-1, dDIM+1, ..., dn), where (d1, d2,..., dn) is the shape of MASK. Each element in an array result is true only if all elements in the one dimensional array defined by MASK (s1, s2, ..., sDIM-1, :, sDIM+1, ..., sn) are true. | ||
Examples
ALL ((/.TRUE., .FALSE., .TRUE./)) has the value false because some elements of MASK are not true.
ALL ((/.TRUE., .TRUE., .TRUE./)) has the value true because all elements of MASK are true.
A is the array
[ 1 5 7 ]
[ 3 6 8 ]
[ 0 5 7 ]
[ 2 6 9 ].
ALL (A .EQ. B, DIM=1) tests to see if all elements in each column of A are equal to the elements in the corresponding column of B. The result has the value (false, true, false) because only the second column has elements that are all equal.
ALL (A .EQ. B, DIM=2) tests to see if all elements in each row of A are equal to the elements in the corresponding row of B. The result has the value (false, false) because each row has some elements that are not equal.