Функции и команды для работы с массивами

ACOPY (SourceArrayName, DestinationArrayName

[, nFirstSourceElement [, nNumberElements [, nFirstDestElement]])]

Копирует элементы из одного массива в другой.

SourceArrayName – исходный массив

DestinationArrayName – результирующий массив.

Массивы могут быть одно - или двумерные. Если результирующий массив не существует, VFP автоматически создает его.

NFirstSourceElement - первый элемент в исходном массиве, который будет скопирован;

NNumberElements - число элементов для копирования. Если nNumberElements -1, все элементы исходного массива, начиная с элемента nFirstSourceElement будут скопированы.

NFirstDestElement Определяет первый элемент в результирующем массиве.

 

ADEL (ArrayName, nElementNumber [,] 2)

Удаляет элемент из одномерного массива, или строки или столбцы из двумерного массива.

ArrayName Определяет массив из которого удаляются элемент, строка, или столбец.

nElementNumber Определяет номер элемента, строки, или столбца для удаления.

 

ADIR (ArrayName [, cFileSkeleton [, cAttribute]])

Заносит информацию о файлах в массив и возвращает число файлов.

ArrayName – имя массива.

Следующая таблица описывает содержание и тип данных каждого столбца в массиве:

 

Столбец	Информация	Тип данных
	Имена файла	Строка символов
	Размер файла	Числовой
	Дата последней модификации	Дата
	Время последней модификации	Строка символов
	Атрибуты файла	Строка символов

CFileSkeleton – шаблон имени файла. Разрешается использовать символы обощения * и?.

CAttribute может содержать любую комбинацию символов D, H, и S.

 

AELEMENT()

 

AFIELDS(ArrayName [, nWorkArea | cTableAlias]) Размещает информацию о структуре таблицы в массиве и возвращает число полей.

AINS(ArrayName, nElementNumber [, 2]) Добавляет элемент в одномерный массив, или строку или столбец в двумерный массив.

ALEN (ArrayName [, nArrayAttribute])

Возвращает число элементов, строк, или столбцов в массиве.

ArrayName – имя массива.

NArrayAttribute Определяет что возвращает ALEN () число элементов, строк или столбцов в массиве.

0 Возвращает число элементов в массиве.

1 Возвращает число строк в массиве.

2 Возвращает число столбцов в массиве.

 

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

Просматривает массив в поисках элемента содержащего значение заданное выражением eExpression. Если элемент найден возвращается его номер или 0 в противном случае.

 

ASORT(ArrayName [, nStartElement [, nNumberSorted [, nSortOrder]]])

Упорядочивает элементы в массиве в возрастающем или убывающем порядке.

ASUBSCRIPT()

 

Команды для работы с массивами

DECLARE /DIMENSION

См. выше

 

COPY TO ARRAY

Копирует данные из таблицы в массив.

 

Синтаксис

 

COPY TO ARRAY ArrayName

[FIELDS FieldList]

[Scope] [FOR lExpression1] [WHILE lExpression2]

[NOOPTIMIZE]

 

Аргументы

 

ArrayName Определяет массив, в который копируются данные.

 

FieldList указывает поля таблицы которые будут копироваться в массив. Если FieldList, не указан, копируются все поля.

 

APPEND FROM ARRAY

Добавляет одну запись в таблицу для каждой строки в массиве и заполняет каждую запись данными из соответствующей строки массива.

 

Синтаксис

APPEND FROM ARRAY ArrayName

[FOR lExpression]

[FIELDS FieldList]

 

Аргументы

ArrayName Определяет имя массива, который содержит данные для добавления в таблицу.

Если присутствует список FieldList, то только указанные поля переносятся из массива в таблицу.

 

Пара команд SCATTER - GATHER

SCATTER

Копирует данные из текущей записи таблицы в переменные или массив.

 

Синтаксис

 

SCATTER

[FIELDS FieldNameList

| FIELDS LIKE Skeleton | FIELDS EXCEPT Skeleton] [MEMO]

TO ArrayName | TO ArrayName BLANK | MEMVAR | MEMVAR BLANK

| NAME ObjectName

 

Аргументы

 

FIELDS FieldNameList Определяет поля, которые будут переданы в переменные или массив.

FIELDS LIKE Skeleton | FIELDS EXCEPT Skeleton] можно избирательно переносить поля в переменные или массив включением предложения LIKE ИЛИ EXCEPT или обоих.

Шаблон имени поля поддерживает символы обобщения.

Предложение LIKE может быть объединено с предложением EXCEPT:

MEMVAR переносит данные в множество переменных вместо массива. SCATTER создает одну переменную для каждого поля в таблице и заполняет каждую переменную данными из соответствующего поля в текущей записи, присваивая переменной то же самое название, размер, и тип.

GATHER

Заменяет данные в текущей записи таблицы с данными из массива, множества переменных, или объекта.

 

Синтаксис

 

GATHER FROM ArrayName | MEMVAR | NAME ObjectName

[FIELDS FieldList | FIELDS LIKE Skeleton | FIELDS EXCEPT Skeleton]

[MEMO]

 

Аргументы

 

FROM ArrayName Определяет массив, данные из которого заменяют данные в текущей записи таблицы. Значение первого элемента массива заменяет первое поле в текущей записи; значение второго элемента массива заменяет второе поле, и так далее.

Если массив имеет меньшее количество элементов чем таблица полей, дополнительные поля игнорируются. Если массив имеет большее количество элементов чем таблица полей, дополнительные элементы массива игнорируются.

Контрольные вопросы.

1. Перечислите операторы управления ходом выполнения программы.

2. Какие команды используются для удаления данных?

3. Оператор Replace – его назначение и синтаксис.

4. Сформулируйте классификацию функций Visual Foxpro.

 

 

Лекция 8