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, Вверх: Внутренние процедуры [Содержание][Индекс]