Функция AINS( )

Вставляет элемент в одномерный массив или вставляет строку или столбец в двуме ный массив.

Синтаксис

AINS(ArrayName, nElementNumber [, 2])

Параметры

ArrayName

Задает имя массива, в который вставляется элемент.

nElementNumber

Задает место в массиве, куда следует вставить новый элемент, строку или стол ец.

Чтобы вставить элемент в одномерный массив, укажите ArrayName и номер nElementNumber, под которым он должен быть вставлен. Новый элемент вставляется непосредствен о перед элементом, носившим номер nElementNumber. Чтобы вставить строку в двумерный массив, задайте ArrayName и номер строки nElementNumber, перед которой нужно сделать вставку. Новая строка будет вставлена непосре ственно перед строкой с номером nElementNumber.

Подробнее о том, как ссылаться на элементы массива по их индексам, см. описа ие команды DIMENSION.

2

Вставляет столбец в двумерный массив. Новый столбец вставляется непосредствен о перед столбцом, заданным номером nElementNumber.

Результат

Числовой

Комментарии

Вставка в массив элемента, строки или столбца не изменяет размера массива. Пос едующие элементы, строки и столбцы сдвигаются к концу массива, а последний э емент, строка или столбец массива теряются. Вновь вставленный элемент, строка и и столбец инициализируется значением "ложь" (.F.).

Функция AINS( ) возвращает 1 в случае успешной вставки элемента, строки или столбца.