Spec-Zone.ru › GNU Fortran 13

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 — Положение минимального значения в массиве

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-13.3.0/gfortran/FINDLOC.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API