COMSafeArray.Из массива 1

COMSafeArray (COMSafeArray)

Из массива 1

Синтаксис:

Новый COMSafeArray(<Массив>, <ТипЭлемента>, <<разм0>,...,<размN-1>>)

Параметры:

<Массив> (обязательный)

Тип: Массив.
Массив - источник данных для COMSafeArray.

<ТипЭлемента> (обязательный)

Тип: Строка.
Определяет тип элемента COMSafeArray.

<<разм0>,...,<размN-1>> (необязательный)

Тип: Число.
Количество элементов COMSafeArray по каждой из размерностей, начиная со старшей.

<разм0> задает количество элементов по нулевому, самому старшему, измерению COMSafeArray;
<разм1> - по первому измерению, если COMSafeArray более чем двумерный;

и так далее. Всего параметров столько, сколько измерений должно быть в COMSafeArray.

Описание:

Создает COMSafeArray с заданным типом элемента из элементов массива значений.
Значения элементов COMSafeArray выбираются из массива, заданного в параметре <ТипЭлемента> по следующему правилу:

Каждое значение старшего индекса COMSafeArray определяет его срез с количеством измерений на 1 меньше.
Для каждого значения старшего индекса из COMSafeArray выбирается соответствующее значение из массива и этим значением инициализируется срез COMSafeArray. Если в массиве нет значения с соответствующим индексом, то срез COMSafeArray инициализируется значением типа Неопределено.

Так продолжается до тех пор, кока срез не станет одним элементом COMSafeArray.
Если срез не является элементом, а элемент массива не является массивом, то считается, что он является массивом длины 1.
Если размерности COMSafeArray заданы, то построенный COMSafeArray будет иметь заданные размерности. Если не заданы, то они определяются по максимальным индексам массива и максимальному уровню вложенности массивов.

Пример:

// Построить двумерный COMSafeArray с типом элемента VT_I4

// из двух строк и трех колонок. Значения элементов

// взять из массива.

Массив1 = Новый Массив;
// заполнение массива Массив1 значениями

// ...

Массив2 = Новый COMSafeArray(Массив1, "VT_I4", 2, 3);

Оглавление | Родительский раздел Платформа 8.3.13.1809