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

Другое · 6 мин

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

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

В 1С:Предприятии процедура предназначена для выполнения действий, а не для вычисления и возврата результата. Оператор Возврат внутри процедуры только завершает её выполнение, но не передаёт значение вызывающему коду. Поэтому попытка получить результат из обычной процедуры через присваивание, например Результат = МояПроцедура(), приведёт к синтаксической ошибке или к получению неопределённого значения.

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

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

Отличие процедуры от функции в 1С

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

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

Обычная процедуране возвращает значение

Проверьте, объявлена ли подпрограмма через Процедура, а не через Функция

Код вызоваприсваивание результата

Убедитесь, что вы не пытаетесь записать вызов процедуры в переменную

Нужный результатвычисляемое значение

Определите, достаточно ли заменить процедуру на функцию или нужен выходной параметр

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

Создайте функцию с тем же набором параметров, перенесите в неё вычислительную часть процедуры и завершите оператором Возврат <имя переменной>. Вызывающий код получает возможность написать Результат = МояФункция(Параметры) и работать с полученным значением.

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

Порядок действий
  1. 1
    Объявите функцию вместо процедуры с теми же параметрами
  2. 2
    Перенесите вычислительную часть и завершите её Возврат значением
  3. 3
    Замените вызов процедуры на присваивание результата функции
  4. 4
    Проверьте работу на копии информационной базы

Способ 2: выходной параметр процедуры

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

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

Экспорт процедуры и функции из общего модуля

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

Экспорт не меняет правила возврата значения: экспортируемая процедура по-прежнему не возвращает результат, а экспортируемая функция — возвращает. При переносе кода между конфигурациями проверяйте права доступа и видимость модуля.

Типичные ошибки
01
Попытка присвоить вызов процедуры переменной приводит к ошибке или неопределённому результату
02
Забыть оператор Возврат в функции, после чего вызывающий код получает неопределённое значение
03
Изменять объект через параметр процедуры и не ожидать побочных эффектов у вызывающего кода

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

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

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

Когда правка модуля требует осторожности

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

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

Итог

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

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

Можно ли написать Возврат со значением внутри процедуры?

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

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

Функция вычисляет и возвращает результат через оператор Возврат, а процедура выполняет действия и не возвращает вычисляемое значение вызывающему коду.

Когда использовать выходной параметр вместо функции?

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

Что делать, если процедура уже меняет данные и нужно ещё получить результат?

Разделите изменения данных и вычисление результата, либо добавьте выходной параметр, но проверьте, что порядок выполнения и побочные эффекты не приведут к некорректным данным.