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

Другое · 5 мин

Функция и процедура в 1С: в чем разница и когда что использовать

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

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

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

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

Отличие в объявлении и вызове

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

Функция подходит, когда нужно получить число, строку, дату, ссылку или другой объект. Примерно так может выглядеть объявление: Функция Сумма(Число1, Число2) Экспорт, а в теле — Возврат Число1 + Число2;.

Вызов функции может быть частью большего выражения: Итог = Сумма(А, Б) + Налог;. Вызов процедуры в таком контексте недопустим, потому что у процедуры нет возвращаемого значения.

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

Функция

Когда нужно получить значение для выражения, присваивания или условия.

Процедура

Когда нужно выполнить последовательность действий без возврата результата.

Где можно использовать функцию, а где процедуру

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

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

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

Параметры и изменение данных

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

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

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

Проверка результата и отладка

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

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

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

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

Частые ошибки и ограничения

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

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

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

Как выбрать: краткий маршрут

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

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

Итог

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

Функция возвращает результат, процедура — нет; это определяет место вызова и способ проверки.

Можно ли вызвать функцию как процедуру?

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

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

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

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

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

Где проверить, что выбрано верно?

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