MINLOC — Location of the minimum value within an array#
-
MINLOC(ARRAY, MASK, KIND, BACK)#
Determines the location of the element in the array with the minimum value, or, if the
DIM
argument is supplied, determines the locations of the minimum element along each row of the array in theDIM
direction. IfMASK
is present, only the elements for whichMASK
is.TRUE.
are considered. If more than one element in the array has the minimum value, the location returned is that of the first such element in array element order if theBACK
is not present, or is false; ifBACK
is true, the location returned is that of the last such element. If the array has zero size, or all of the elements ofMASK
are.FALSE.
, then the result is an array of zeroes. Similarly, ifDIM
is supplied and all of the elements ofMASK
along a given row are zero, the result value for that row is zero.- Parameters
ARRAY – Shall be an array of type
INTEGER
,REAL
orCHARACTER
.DIM – (Optional) Shall be a scalar of type
INTEGER
, with a value between one and the rank ofARRAY
, inclusive. It may not be an optional dummy argument.MASK – Shall be of type
LOGICAL
, and conformable withARRAY
.KIND – (Optional) An
INTEGER
initialization expression indicating the kind parameter of the result.BACK – (Optional) A scalar of type
LOGICAL
.
- Returns
If
DIM
is absent, the result is a rank-one array with a length equal to the rank ofARRAY
. IfDIM
is present, the result is an array with a rank one less than the rank ofARRAY
, and a size corresponding to the size ofARRAY
with theDIM
dimension removed. IfDIM
is present andARRAY
has a rank of one, the result is a scalar. If the optional argumentKIND
is present, the result is an integer of kindKIND
, otherwise it is of default kind.
- Standard:
Fortran 90 and later;
ARRAY
ofCHARACTER
and theKIND
argument are available in Fortran 2003 and later. TheBACK
argument is available in Fortran 2008 and later.- Class:
Transformational function
- Syntax:
RESULT = MINLOC(ARRAY, DIM [, MASK] [,KIND] [,BACK]) RESULT = MINLOC(ARRAY [, MASK], [,KIND] [,BACK])
- See also:
FINDLOC — Search an array for a value, MIN, MINVAL — Minimum value of an array