8.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	(Необязательно) INTEGER выражение инициализации, указывающее параметр вида результата.
BACK	(Необязательно) Скаляр типа LOGICAL.

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

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

См. также:

MAXLOC, MINLOC

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