Spec-Zone.ru › GNU Fortran 14

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

Описание:

Определяет положение элемента в массиве со значением, заданным в аргументе VALUE, или, если присутствует аргумент DIM, определяет позиции элементов, равных элементу VALUE, вдоль каждой строки массива в направлении DIM. Если присутствует MASK, учитываются только те элементы, для которых MASK .TRUE. . Если в массиве более одного элемента со значением VALUE, возвращаемое положение — это положение первого такого элемента в порядке следования элементов массива, если BACK отсутствует или если оно .FALSE.. Если BACK истинно, возвращаемое положение — это положение последнего такого элемента. Если массив имеет нулевой размер или все элементы 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-14.2.0/gfortran/FINDLOC.html

Spec-Zone.ru

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