Команда DIMENSION

Создает одномерный или двумерный массив переменных памяти.

Синтаксис

DIMENSION ArrayName1 (nRows1 [, nColumns1])
[, ArrayName2 (nRows2 [, nColumns2])] ...

Параметры

ArrayName1

Задает имя массива. Одной командой DIMENSION можно создать сразу несколько массивов, если включить имена всех этих массивов (ArrayName2, ArrayName3 и т.д.).

nRows1 [, nColumns1]

Задает размер создаваемого массива. Если указать только nRows1, будет создан одномерный массив, состоящий из одного столбца и nRows1 строк. Например, следующая команда создает одномерный массив gaArrayOne, содержащий один столбец и десять строк.

DIMENSION gaArrayOne(10)

Чтобы создать двумерный массив, укажите как nRows1, так и nColumns1. Аргумент nRows1 задает число строк в массиве, а nColumns1 число столбцов. В следующем примере создается двумерный массив gaArrayTwo, содержащий две строки и четыре столбца:

DIMENSION gaArrayTwo(2,4)

Нужно указывать размер каждого массива, создаваемого командой DIMENSION. В сле ующем примере создаются три массива: gaArrayOne и gaArrayTwo из предыдущих примеров, а также третий массив gaArrayThree:

DIMENSION gaArrayOne(10), gaArrayTwo(2,4), gaArrayThree(3,3)

В командах DIMENSION и DECLARE выражения размерности можно заключать как в к углые скобки, так и в квадратные. Например, приведенные ниже две команды создают идентичные массивы:

DIMENSION gaArrayOne(10), gaArrayTwo[2,4], gaArrayThree(3,3)

DIMENSION gaArrayOne[10], gaArrayTwo(2,4), gaArrayThree[3,3]

Элементы массива

Размер массива определяет, сколько элементов он в состоянии вместить. Каждый э емент массива может хранить одну порцию информации. Чтобы определить, сколько лементов содержит массив и какой объем информации в нем можно хранить, ум ожьте число строк массива (nRows1) на число столбцов (nColumns1).

Элементы массива могут содержать данные любого типа; когда массив впервые соз ается, его элементы инициализируются значением "ложь" (.F.). С помощью команды STORE можно проинициализировать все элементы массива одним значением, если уста овка SET COMPATIBLE имеет значение FOXPLUS или OFF (принимается по умолчанию). Например:

DIMENSION gaArray(10,3)

STORE 'initial' TO gaArray

Индексы массива

Ссылаться на элементы массива можно по их индексам. У каждого элемента массива имеется уникальный числовой индекс, идентифицирующий его. Если массив одномерн й, индекс элемента это номер его строки. Например, индекс элемента, находящегося в третьей ст оке одномерного массива, равен 3.

Элементы в двумерных массивах обозначаются двумя индексами. Первый индекс указ вает положение элемента в строках, а второй индекс его положение в столбцах. Например, индексами элемента, находящегося в т етьей строке и четвертом столбце двумерного массива, будут 3,4. Подробнее об ин ексах элементов массивов см. описание функции ASUBSCRIPT( ).

Индекс (индексы) первого элемента массива всегда равен 1. Если массив двумерн й, его также можно обозначить одним числом. Функция AELEMENT( ) возвращает оди очный индекс для пары строчного и столбцевого индексов, а функция ASUBSCRIPT( ) возвращает строчный и столбцевой индексы элемента из его одиночного индекса.

Изменение размеров массивов

Повторно выдавая команду DIMENSION, можно изменять размер и размерность массива. Размер массива можно увеличивать и уменьшать, одномерные массивы можно преоб азовывать в двумерные, а двумерные в одномерные.

Если число элементов в массиве увеличивается, значения всех элементов перво ачального массива копируются в новый расширенный массив. Дополнительные элементы массива инициализируются значением "ложь" (.F.).

Комментарии

Команда DIMENSION идентична по выполняемым действиям и по синтаксису команде DECLARE.