Другое · 7 мин
Как из функции вернуть несколько значений в 1С
В 1С функция возвращает одно значение, поэтому несколько результатов упаковывают в структуру, массив или таблицу значений, а также передают объект по ссылке. Подходит для автоматизации учета.
В языке встроенных функций 1С:Предприятия одна функция может вернуть только одно значение. Это ограничение не означает, что нельзя получить из функции несколько результатов: их нужно упаковать в одно составное значение или изменить переданный вызывающим кодом объект.
На практике чаще всего используют Структуру, Массив или ТаблицуЗначений. Также можно передать в функцию пустую структуру или таблицу и заполнить её внутри, так как сложные объекты передаются по ссылке, а изменения остаются видимыми после завершения функции.
Выбор способа зависит от того, какие данные нужно вернуть, где вызывается функция и как вызывающий код будет обрабатывать результат. Неправильная упаковка приводит к трудноотлавливаемым ошибкам, особенно при работе клиент-сервер и при передаче значений между тонким и толстым клиентом.
Почему функция возвращает одно значение
Синтаксис 1С не предусматривает несколько операторов Возврат в одной функции и не позволяет вернуть список отдельных значений через запятую. После первого выполнения Возврат управление передаётся обратно вызывающему коду, поэтому все остальные инструкции после него не выполняются.
Если нужно получить из функции и код выполнения, и текст сообщения, и набор данных, приходится объединять их в одно контейнерное значение. Это стандартный приём при разработке обработок, отчётов и сервисных функций для автоматизации учета.
Способы вернуть несколько результатов
Наиболее распространённый способ — вернуть Структуру с именованными полями. Например, функция может вернуть структуру с ключами Код, Наименование, Сумма и Результат. Вызывающий код обращается к полям по именам, что делает программу читаемой.
- 1Определите, какие значения нужно вернуть и какие у них типы
- 2Выберите контейнер: Структура, Массив или ТаблицаЗначений
- 3Заполните контейнер внутри функции и выполните Возврат
- 4В вызывающем коде получите значение и обратитесь к полям или строкам
- 5Проверьте, что все ожидаемые ключи или колонки присутствуют
Если порядок элементов важен, а названия полей не нужны, подходит Массив. Для набора однородных записей удобнее вернуть ТаблицуЗначений. Когда нужно изменить переданный объект внутри функции и оставить изменения после выхода, передают пустую Структуру или ТаблицуЗначений и заполняют их внутри функции.
Пример с Strukturoi и доступ к полям
Функция может создать структуру через конструктор Новый Структура и заполнить её значениями. После получения результата вызывающий код проверяет наличие ключа с помощью метода Свойство или обращается к полю напрямую, если уверен в его наличии.
Сравнение вариантов
Подходит для именованных характеристик одного объекта; требует знания имён ключей.
Удобен для упорядоченного набора однородных значений без имен.
Оптимальна для возврата нескольких записей с одинаковыми колонками; больше объём данных.
Подходит, когда нужно изменить объект внутри функции; не работает с примитивами.
Функция ПолучитьДанныеКонтрагента(КодКонтрагента) Экспорт
Результат = Новый Структура;
Результат.Вставить("Код", КодКонтрагента);
Результат.Вставить("Наименование", "ООО Пример");
Результат.Вставить("СуммаЗадолженности", 12500);
Возврат Результат;
КонецФункции
Данные = ПолучитьДанныеКонтрагента("000000001");
Если Данные.Свойство("СуммаЗадолженности") Тогда
Сообщить(Данные.Наименование + ": " + Данные.СуммаЗадолженности);
КонецЕсли;
Важно не путать имена свойств в разных частях программы. Если одна часть разработки ожидает поле Сумма, а другая — СуммаЗадолженности, код завершится ошибкой или вернёт неопределённое значение. Поэтому имена ключей лучше фиксировать в общем модуле или константе.
Передача объекта для заполнения вместо возврата
Некоторые задачи удобнее решить через процедуру, которая принимает пустую структуру или таблицу и заполняет её. Так как структура передаётся по ссылке, изменения остаются доступными вызывающему коду после завершения процедуры. Это удобно, когда нужно вернуть много связанных данных и избежать создания большого возвращаемого объекта.
Однако с примитивными значениями, такими как число, строка или дата, такой подход не сработает: изменения параметра внутри функции не будут видны снаружи. Для возврата нескольких примитивов всё равно нужно использовать составной контейнер.
Ограничения клиент-сервера и типов значений
При вызове функции на сервере из клиента возвращаемое значение должно поддерживать передачу между клиентом и сервером. Не стоит возвращать ссылки на элементы формы, временные объекты сессии или другие привязки к текущему окну. Такие значения могут стать недоступными или вызвать ошибку при передаче.
Как проверить результат
Метод Свойство возвращает Истина
Ошибка при обращении к отсутствующему полю
Соответствует ожидаемой структуре
Отсутствуют нужные колонки или строки
Также стоит учитывать, что сложные контейнеры увеличивают объём передаваемых данных. Если функция вызывается часто и в цикле, возврат большой таблицы значений может замедлить работу. В таких случаях лучше ограничить набор полей или загружать данные по запросу.
Проверка результата и типичные ошибки
Перед использованием полей структуры или колонок таблицы стоит убедиться, что они существуют. Обращение к отсутствующему свойству структуры может привести к ошибке в режиме обычного приложения. Метод Свойство помогает проверить наличие ключа без прерывания работы.
Частая ошибка — попытка изменить примитивный параметр функции и ожидать, что значение вернётся вызывающему коду. Другая ошибка — возвращать структуру с разными наборами ключей в разных ветках кода, что заставляет вызывающий код выполнять лишние проверки.
Как выбрать подходящий способ
Если нужно вернуть несколько связанных характеристик одного объекта, выбирайте Структуру. Если важен порядок и однородность элементов — Массив. Если результат представляет набор записей с одинаковыми колонками — ТаблицуЗначений. Когда функция должна изменить переданный вызывающим кодом объект, используйте процедуру с заполнением структуры или таблицы по ссылке.
Что важно запомнить
Одна функция в 1С возвращает одно значение; несколько результатов упаковывают в контейнер или заполняют переданный объект, а затем проверяют ключи перед использованием.
Частые вопросы
Можно ли вернуть из функции несколько значений через запятую?
Нет, синтаксис 1С позволяет выполнить оператор Возврат только с одним выражением. Несколько результатов нужно упаковать в структуру, массив или таблицу значений.
Что лучше: структура или таблица значений?
Структура удобнее для одного объекта с несколькими характеристиками, таблица значений — для набора записей с одинаковыми колонками. Выбор зависит от того, как вызывающий код будет обходить результат.
Нужно ли проверять наличие ключей в возвращаемой структуре?
Да, особенно если структура формируется в разных ветках кода или поступает из внешнего модуля. Проверка через Свойство помогает избежать ошибок при обращении к отсутствующему полю.
Можно ли изменить параметр функции и вернуть результат через него?
Для сложных объектов, таких как структура или таблица значений, изменения остаются видимыми после завершения функции. Для чисел, строк и дат такой подход не сработает.