Функция ASCAN( )

Просматривает массив в поисках элемента, данные которого имеют то же значение и тот же тип, что и указанное выражение.

Синтаксис

ASCAN(ArrayName, eExpression [, nStartElement [, nElementsSearched]])

Параметры

ArrayName

Задает имя массива, в котором будет идти поиск.

eExpression

Задает выражение общего типа, которое нужно найти.

nStartElement

Задает номер элемента, с которого начнется поиск. Указанный элемент также п оверяется при поиске. Если номер nStartElement опущен, по умолчанию просматривается весь массив.

nElementsSearched

Задает количество просматриваемых элементов. Если аргументы nStartElement и nElementsSearched опущены, поиск начинается с первого элемента массива и завершается последним э ементом.

Замечание Элемент двумерного массива переменных памяти можно указывать двумя спосо ами: либо с помощью двух индексов, задающих позиции элемента в массиве по строкам и по столбцам, либо с помощью одиночного номера. Данная функция, как и ряд д угих функций, манипулирующих двумерными массивами, требует задания номеров элеме тов (nStartElement and nElementsSearched). Для получения номера элемента исходя из его строчного и столбцевого ин ексов используйте функцию AELEMENT( ).

Результат

Числовой

Комментарии

Если совпадающий элемент найден, функция ASCAN( ) возвращает его номер. Если такой элемент найти не удалось, ASCAN( ) возвращает 0.

Критерий сопоставления символьных данных определяется установкой SET EXACT. Ес и команда SET EXACT установила значение ON, элемент должен посимвольно совпа ать с искомым выражением и иметь ту же длину. Если действует установка SET EXACT OFF, а элемент и искомое выражение совпали вплоть до конца выражения, считается, что элемент найден. Подробнее о критерии сопоставления символьных строк см. в таблице сравнения строк в описании команды SET EXACT.