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

Описание:

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

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

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

См. также:

MAXLOC, MINLOC

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