9.108 FINDLOC — Поиск значения в массиве

Описание:

Определяет положение элемента в массиве со значением, заданным в аргументе VALUE, или, если указан аргумент DIM, определяет положения элементов, равных элементу VALUE, вдоль каждой строки массива в направлении DIM. Если присутствует MASK, учитываются только элементы, для которых MASK равно .TRUE.. Если в массиве имеется более одного элемента со значением VALUE, возвращаемое положение — это положение первого такого элемента в порядке следования элементов массива, если аргумент BACK отсутствует или равен .FALSE.. Если BACK имеет значение true, возвращаемое положение — это положение последнего такого элемента. Если массив имеет нулевой размер или все элементы MASK равны .FALSE., то результат — массив из нулей. Аналогично, если задан DIM и все элементы MASK вдоль заданной строки равны нулю, то значение результата для этой строки равно нулю.

Стандарт:

Fortran 2008 и более поздние версии.

Класс:

Функция преобразования

Синтаксис:

RESULT = FINDLOC(ARRAY, VALUE, DIM [, MASK] [,KIND] [,BACK])

RESULT = FINDLOC(ARRAY, VALUE, [, MASK] [,KIND] [,BACK])

Аргументы:

ARRAY	Должен быть массивом внутреннего типа.
VALUE	Скаляр внутреннего типа, совместимый по типу с ARRAY.
DIM	(Необязательно) Должен быть скаляром типа INTEGER, со значением от одного до ранга ARRAY включительно. Он не может быть необязательным аргументом.
MASK	(Необязательно) Должен быть типа LOGICAL, и совместим по форме с ARRAY.
KIND	(Необязательно) Выражение инициализации, указывающее параметр вида результата.
BACK	(Необязательно) Скаляр типа LOGICAL.

Возвращаемое значение:

Если DIM отсутствует, результат — массив ранга один с длиной, равной рангу ARRAY. Если DIM присутствует, результат — массив с рангом на единицу меньше ранга ARRAY и размером, соответствующим размеру ARRAY с удаленной размерностью DIM. Если DIM присутствует и ARRAY имеет ранг один, результат — скаляр. Если необязательный аргумент KIND присутствует, результат — целое число типа KIND, в противном случае — стандартного типа.

См. также:

MAXLOC, MINLOC

Следующая: FLOOR, Предыдущая: FGETC, Наверх: Встроенные процедуры [Содержание][Индекс]