О2_Утилиты.МассивИзвестногоРазмера
Создаёт массив указанного размера. В отличие от штатного конструктора Новый Массив(Размер), корректно обрабатывает нулевой размер: платформа 1С запрещает создание массива с явно указанным нулевым размером и выбрасывает исключение «Недопустимое значение параметра». Метод снимает это ограничение, возвращая в этом случае пустой массив.
Основной способ вызова — через фасад О2.Утилиты().МассивИзвестногоРазмера(...).
Синтаксис
О2.Утилиты().МассивИзвестногоРазмера(Размер)
Параметры
- Размер — Число — количество элементов создаваемого массива. Допускается значение
0.
Возвращаемое значение
- Массив из Произвольный — массив указанного размера. Все элементы инициализированы значением
Неопределено.
Описание
Метод предназначен для случаев, когда размер массива становится известен динамически (например, по количеству элементов исходной коллекции) и может оказаться равным нулю. Использование метода устраняет необходимость в каждом таком месте писать защитную проверку Если Размер = 0 Тогда ....
В коде метод вызывается через фасад О2.Утилиты(), который возвращает общий модуль О2_Утилиты. Основная форма вызова — О2.Утилиты().МассивИзвестногоРазмера(...).
Пример
Заполнение массива результатов по входной коллекции произвольного размера через фасад О2.Утилиты().МассивИзвестногоРазмера(...):
Результат = О2.Утилиты().МассивИзвестногоРазмера(Значения.Количество());
Для К = 0 По Значения.ВГраница() Цикл
Результат[К] = Преобразовать(Значения[К]);
КонецЦикла;
При Значения.Количество() = 0 метод вернёт пустой массив, цикл не выполнится, исключения не будет.
См. также
- Утилиты.Массив — создание массива из перечисленных значений;
- Утилиты.МассивЧиселИзСтроки — разбор строки с разделителями в массив чисел;
- Утилиты (обзор) — все вспомогательные методы.