ALL(3I) Last changed: 1-6-98
ALL - Determines whether all values are true
ALL ([MASK=]mask [,[DIM=]dim])
UNICOS, UNICOS/mk, and IRIX systems
Fortran 90
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.
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
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.]
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.
ALL(3I) Last changed: 1-6-98
ALL - Determines whether all values are true
ALL ([MASK=]mask [,[DIM=]dim])
UNICOS, UNICOS/mk, and IRIX systems
Fortran 90
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.
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
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.]
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.
[ Back ]
|
