Как получить массив из функции в 1С

Во встроенном языке 1С функция может возвращать значение любого типа, включая массив. Для этого достаточно создать объект типа «Массив» внутри функции, заполнить его элементами и вернуть через оператор Возврат. Никакого специального объявления типа возвращаемого значения не требуется — язык динамически типизирован.

Такой приём постоянно используется в прикладной разработке: функция подбирает список документов по отбору, собирает значения из запроса, формирует набор параметров для дальнейшей обработки. Понимание того, как правильно сформировать и вернуть массив, помогает избежать типичных ошибок — пустых коллекций, потери данных при передаче между клиентом и сервером и лишних копирований.

Ниже разобраны базовый синтаксис, заполнение массива из запроса, передача массива через параметры, особенности клиент-серверного взаимодействия и проверка результата.

Базовый способ: вернуть массив через оператор Возврат

Самый простой вариант — объявить массив внутри функции, наполнить его и вернуть как результат. Вызывающий код получает готовую коллекцию и может сразу обращаться к элементам по индексу или обходить их в цикле.

Функция ПолучитьСписокСкладов()

МассивСкладов = Новый Массив;
МассивСкладов.Добавить("Основной склад");
МассивСкладов.Добавить("Склад резерва");
МассивСкладов.Добавить("Транзитный склад");

Возврат МассивСкладов;

КонецФункции

Обращение к результату выглядит так:

Склады = ПолучитьСписокСкладов();
Для Каждого Склад Из Склады Цикл
Сообщить(Склад);
КонецЦикла;

Обратите внимание: если внутри функции есть несколько веток логики, каждая ветка, завершающаяся оператором Возврат, должна возвращать однотипный результат. Если в одной ветке возвращается массив, а в другой — Неопределено, вызывающий код обязан это учитывать, иначе обход коллекции завершится ошибкой.

Функция ПолучитьМассив()
	Результат = Новый Массив;
	Результат.Добавить("Элемент1");
	Возврат Результат;
КонецФункции

Заполнение массива из запроса к базе данных

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

Функция ПолучитьДокументыЗаПериод(НачалоПериода, КонецПериода)

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   РеализацияТоваровУслуг.Ссылка КАК Ссылка
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
|ГДЕ
|   РеализацияТоваровУслуг.Дата МЕЖДУ &Начало И &Конец
|   И РеализацияТоваровУслуг.Проведен";

Запрос.УстановитьПараметр("Начало", НачалоПериода);
Запрос.УстановитьПараметр("Конец", КонецПериода);

Выборка = Запрос.Выполнить().Выгрузить();
Возврат Выборка.ВыгрузитьКолонку("Ссылка");

КонецФункции

Метод ВыгрузитьКолонку() возвращает именно массив, поэтому дополнительное копирование не нужно. Если запрос не нашёл ни одной строки, функция вернёт пустой массив — это корректное состояние, а не ошибка. Вызывающий код должен проверять Количество() перед обращением к элементам по индексу.

Если нужен массив структур (например, ссылка плюс сумма документа), обходите выборку в цикле и добавляйте в массив заполненные структуры. Это чуть длиннее, но сохраняет несколько полей для каждой строки.

Альтернатива: заполнение массива через параметр функции

Второй подход — передать массив в функцию как параметр и заполнять его внутри. Поскольку массив передаётся по ссылке, все изменения, сделанные внутри функции, видны в вызывающем коде. Формально «получить массив из функции» здесь означает получить заполненную коллекцию без оператора Возврат.

Процедура ДобавитьОшибкиВМассив(МассивОшибок)

МассивОшибок.Добавить("Не заполнен контрагент");
МассивОшибок.Добавить("Отсутствует договор");

КонецПроцедуры

// Вызов
Ошибки = Новый Массив;
ДобавитьОшибкиВМассив(Ошибки);
// Ошибки уже заполнен

Этот вариант удобен, когда функция должна вернуть одно значение (например, признак успеха), а массив служит «выходным» контейнером для дополнительных данных — списка ошибок, предупреждений, найденных строк. Возвращаемое значение и наполненный параметр не конфликтуют.

Передача массива между клиентом и сервером

В управляемом приложении функции часто выполняются на сервере, а результат нужен на клиенте. Массив сериализуется платформой автоматически, но только если его элементы — допустимые для передачи типы: примитивы, ссылки, структуры, другие массивы. Объекты типа «Запрос», «ТабличныйДокумент» или COM-объекты передать нельзя.

Для серверной функции в общем модуле убедитесь, что у модуля установлены флажки «Сервер» и «Вызов сервера», иначе обращение с клиента вызовет ошибку компиляции. Функция должна быть экспортной:

// Общий модуль РаботаСДокументами, флажки Сервер + Вызов сервера
Функция ПолучитьСсылкиНаДокументы(Период) Экспорт

// ... запрос и заполнение массива
Возврат МассивСсылок;

КонецФункции

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

Проверка результата и защита от ошибок

После вызова функции полезно убедиться, что вернулся именно массив и он не пуст. Проверка типа выполняется через ТипЗнч(), а наличие элементов — через Количество().

Результат = ПолучитьДокументыЗаПериод(ДатаНачала, ДатаКонца);

Если ТипЗнч(Результат) <> Тип("Массив") Тогда
ВызватьИсключение "Функция вернула не массив";
КонецЕсли;

Если Результат.Количество() = 0 Тогда
Сообщить("Документы за период не найдены");
Возврат;
КонецЕсли;

Отдельный случай — функция, которая при ошибке возвращает Неопределено вместо массива. Такой контракт допустим, но должен быть единообразным во всём коде конфигурации. Более надёжная практика — всегда возвращать массив (пусть и пустой), а факт ошибки передавать отдельно: через исключение, параметр или структуру с признаком успеха.

Типичные ошибки при возврате массива из функции

Большинство проблем связано не с самим синтаксисом, а с контрактом функции: что именно она возвращает в разных ситуациях и как вызывающий код это обрабатывает.

Ещё одна тонкость: если функция объявлена в общем модуле без флажка «Вызов сервера», а обращение идёт с клиента, ошибка возникнет ещё на этапе проверки модуля. Проверяйте свойства общего модуля до отладки логики.

Частые вопросы о массивах в функциях 1С