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

Другое · 7 мин

Что возвращает процедура в 1С: отличие от функции

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

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

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

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

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

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

При описании модуля процедура начинается со слова Процедура, функция — со слова Функция. Компилятор проверяет соответствие: если в теле процедуры попытаться вернуть значение через Return, возникнет ошибка. Если в функции забыть Return, результат может быть неопределённым в зависимости от контекста и типа модуля.

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

Процедуране возвращает значение

Нельзя писать Результат = МояПроцедура()

Функциявозвращает значение

Может использоваться в выражениях и присваиваниях

Return в процедурезавершает выполнение

Не возвращает вызывающему коду данные

Что происходит с параметрами процедуры

Параметры процедуры передаются по значению, поэтому простое присваивание новому значению внутри процедуры не меняет переменную в вызывающем коде. Это важно: нельзя рассчитывать, что процедура «вернёт» изменённую переменную через список параметров.

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

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

Как завершить процедуру до конца

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

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

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

Где процедура может быть вызвана и контекст выполнения

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

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

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

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

Как получить результат, если процедура не подходит

Если требуется значение, замените процедуру на функцию или создайте отдельную функцию рядом с процедурой. Функция может выполнять те же действия и в конце вернуть результат через Return. Это стандартный способ в 1С получить вычисленное значение.

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

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

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

Проверка и частые ошибки

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

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

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

Итог

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

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

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

Нет. Процедура не возвращает значение, поэтому конструкция вроде Результат = МояПроцедура() некорректна. Для присваивания используйте функцию.

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

Замените её на функцию или добавьте функцию, которая возвращает нужное значение. Процедуру можно оставить для действий, а функцию — для расчёта результата.

Может ли процедура изменить переданный объект?

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

Что делает Return внутри процедуры?

Return завершает выполнение процедуры и передаёт управление вызывающему коду. Он не возвращает значение, в отличие от функции.

Как проверить, что процедура отработала корректно?

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