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

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

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

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

Основы возвращения данных из подпрограмм 1С

Фундаментальное отличие функции от процедуры в языке 1С заключается в наличии возвращаемого значения. Чтобы получить массив, ваша подпрограмма должна быть объявлена как Функция, а не Процедура. Внутри тела функции вы формируете объект Массив, наполняете его данными и в конце явно указываете, что именно возвращается.

Синтаксически это выглядит как присваивание имени функции. Платформа интерпретирует строку ИмяФункции = Значение в конце блока как команду возврата. Если вы забудете эту строку, вызывающий код получит значение Неопределено, что приведет к ошибкам при попытке обратиться к элементам коллекции.

Рассмотрим простейший пример создания функции, которая генерирует список чисел. Здесь мы используем встроенный тип Массив, который является динамическим и может хранить данные любого типа.

Функция ПолучитьЧисловойМассив()
МассивРезультат = Новый Массив;
МассивРезультат.Добавить(10);
МассивРезультат.Добавить(20);
МассивРезультат.Добавить(30);

Возврат МассивРезультат; // Или: ПолучитьЧисловойМассив = МассивРезультат
КонецФункции

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

Создание и наполнение массива внутри функции

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

Часто требуется передать не просто примитивные значения, а сложные объекты. Например, массив структур, где каждая структура описывает товар. Это позволяет упаковать связанные данные (Наименование, Артикул, Цена) в одну ячейку коллекции.

• 📦 Используйте метод Добавить() для помещения элемента в конец массива.
• 🔢 Для доступа к элементу используйте квадратные скобки, например Массив[0].
• 🔄 Цикл Для каждого идеально подходит для обработки полученного массива.
• 🧹 Не забывайте очищать временные массивы, если они используются в долгоживущих сеансах.

При работе с большими объемами данных производительность может стать узким местом. Создание массива внутри функции и его возврат по ссылке (что происходит автоматически для объектов) является эффективным способом передачи данных без лишнего копирования памяти.

Работа со сложными типами данных в возвращаемом массиве

Возможности платформы 1С позволяют вкладывать массивы друг в друга, создавая многомерные структуры. Хотя явной поддержки многомерных массивов как в C++ здесь нет, вы можете имитировать их, помещая один массив в ячейку другого. Это полезно для представления иерархических данных, например, справочников с вложенными группами.

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

Тип элемента	Описание	Пример использования
Примитивный (Число, Строка)	Базовые значения	Список идентификаторов документов
Структура	Набор именованных свойств	Карточка сотрудника (ФИО, Должность)
Массив	Вложенная коллекция	Список товаров в заказе
Соответствие	Пары Ключ-Значение	Словарь валют и их курсов

Использование Структур внутри массива является стандартом де-факто для передачи наборов параметров. Это делает код самодокументируемым, так как к полям структуры можно обращаться по именам, а не по индексам.

⚠️ Внимание: При возврате массива объектов убедитесь, что вы не модифицируете его в вызывающем коде непреднамеренно. Поскольку объекты передаются по ссылке, изменения в основном цикле отразятся на исходных данных внутри функции, если она еще не завершила работу (в случае рекурсии или глобальных переменных).

Обработка ошибок и пустых результатов

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

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

Если в процессе выполнения функции произошла ошибка (например, недоступность базы данных или нарушение прав доступа), необходимо корректно обработать ситуацию. Можно использовать конструкцию Попытка...Исключение внутри функции, чтобы гарантировать возврат хотя бы пустой коллекции или специального объекта ошибки.

Почему не стоит возвращать Неопределено?

Возврат Неопределено ломает цепочку вызовов. Если вы планируете сразу перебрать результат в цикле "Для каждого", код упадет с ошибкой, так как Неопределено не является коллекцией. Возврат пустого массива сохраняет целостность логики.

Оптимизация производительности при работе с коллекциями

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

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

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

Практические примеры использования возвращаемых массивов

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

Функция ПолучитьДолжников()
МассивДолжники = Новый Массив;

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Контрагенты.Ссылка, Контрагенты.Наименование ИЗ Справочник.Контрагенты КАК Контрагенты";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
СтруктураДолжника = Новый Структура;
СтруктураДолжника.Вставить("Ссылка", Выборка.Ссылка);
СтруктураДолжника.Вставить("Наименование", Выборка.Наименование);
МассивДолжники.Добавить(СтруктураДолжника);
КонецЦикла;

Возврат МассивДолжники;
КонецФункции

Такой подход позволяет изолировать логику получения данных от логики их отображения. Вы можете вызывать функцию ПолучитьДолжников из разных мест конфигурации, не дублируя код запроса. Это соответствует принципу единственной ответственности.

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

⚠️ Внимание: Интерфейс и методы работы с коллекциями могут незначительно отличаться в разных версиях платформы 1С. Всегда проверяйте синтаксис в справке по вашей конкретной версии конфигурации, особенно если вы поддерживаете старые релизы.

Часто задаваемые вопросы (FAQ)

Можно ли вернуть многомерный массив из функции 1С?

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

В чем разница между возвратом Массива и Таблицы Значений?

Массив — это универсальная коллекция, способная хранить данные любых типов вперемешку. Таблица Значений имеет жесткую структуру колонок и оптимизирована для работы с однородными данными, похожими на записи базы данных. Таблицу значений легче вывести в табличный документ или использовать в запросе как временную таблицу.

Что будет, если забыть оператор Возврат в функции?

Если оператор Возврат отсутствует или функция доходит до конца без явного возврата значения, она вернет Неопределено. Это часто приводит к ошибкам выполнения при попытке использовать результат функции как объект.

Как очистить массив перед возвратом, если он использовался ранее?

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

Можно ли изменить элементы массива после того, как функция его вернула?

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