К статье
Практический материал

Другое · 7 мин

Как из функции вернуть несколько значений в 1С

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

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

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

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

Почему функция возвращает одно значение

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

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

Способы вернуть несколько результатов

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

Порядок действий
  1. 1
    Определите, какие значения нужно вернуть и какие у них типы
  2. 2
    Выберите контейнер: Структура, Массив или ТаблицаЗначений
  3. 3
    Заполните контейнер внутри функции и выполните Возврат
  4. 4
    В вызывающем коде получите значение и обратитесь к полям или строкам
  5. 5
    Проверьте, что все ожидаемые ключи или колонки присутствуют

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

Пример с Strukturoi и доступ к полям

Функция может создать структуру через конструктор Новый Структура и заполнить её значениями. После получения результата вызывающий код проверяет наличие ключа с помощью метода Свойство или обращается к полю напрямую, если уверен в его наличии.

Сравнение вариантов

Структура

Подходит для именованных характеристик одного объекта; требует знания имён ключей.

Массив

Удобен для упорядоченного набора однородных значений без имен.

ТаблицаЗначений

Оптимальна для возврата нескольких записей с одинаковыми колонками; больше объём данных.

Заполнение переданного объекта

Подходит, когда нужно изменить объект внутри функции; не работает с примитивами.

Функция ПолучитьДанныеКонтрагента(КодКонтрагента) Экспорт
Результат = Новый Структура;
Результат.Вставить("Код", КодКонтрагента);
Результат.Вставить("Наименование", "ООО Пример");
Результат.Вставить("СуммаЗадолженности", 12500);
Возврат Результат;
КонецФункции

Данные = ПолучитьДанныеКонтрагента("000000001");
Если Данные.Свойство("СуммаЗадолженности") Тогда
Сообщить(Данные.Наименование + ": " + Данные.СуммаЗадолженности);
КонецЕсли;

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

Передача объекта для заполнения вместо возврата

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

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

Ограничения клиент-сервера и типов значений

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

Контрольные точки

Как проверить результат

Наличие ключа в структуре
Норма

Метод Свойство возвращает Истина

Тревожный признак

Ошибка при обращении к отсутствующему полю

Количество колонок таблицы
Норма

Соответствует ожидаемой структуре

Тревожный признак

Отсутствуют нужные колонки или строки

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

Проверка результата и типичные ошибки

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

Типичные ошибки
01
Обращение к отсутствующему ключу структуры без проверки
02
Изменение примитивного параметра функции с ожиданием возврата значения
03
Разные наборы ключей в возвращаемых структурах в зависимости от условия

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

Как выбрать подходящий способ

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

Итог

Что важно запомнить

Одна функция в 1С возвращает одно значение; несколько результатов упаковывают в контейнер или заполняют переданный объект, а затем проверяют ключи перед использованием.

Частые вопросы

Можно ли вернуть из функции несколько значений через запятую?

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

Что лучше: структура или таблица значений?

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

Нужно ли проверять наличие ключей в возвращаемой структуре?

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

Можно ли изменить параметр функции и вернуть результат через него?

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