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

Другое · 6 мин

Оператор Возврат в 1C: назначение, примеры и ограничения

Разбираем оператор Возврат в языке 1C:Enterprise: когда использовать в функциях и процедурах, как вернуть результат и избежать типичных ошибок.

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

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

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

Что делает оператор Возврат

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

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

Разница между процедурой и функцией

Когда используется процедура

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

Когда используется функция

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

Пример функции:

Функция РассчитатьСкидку(Сумма, Процент)
Возврат Сумма * Процент / 100;
КонецФункции

Пример процедуры с досрочным выходом:

Процедура ОбработатьДокумент()
Если Не ОбъектЗаполнен Тогда
Возврат;
КонецЕсли;
// дальнейшая обработка
КонецПроцедуры
Порядок действий при добавлении Возврат
  1. 1
    Определите, процедура это или функция
  2. 2
    В функции укажите выражение после Возврат
  3. 3
    Проверьте, что код после оператора действительно не должен выполняться
  4. 4
    Протестируйте результат на копии базы

Как возвращать сложные результаты

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

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

Ограничения и риски

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

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

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

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

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

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

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

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

Значение соответствует расчету

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

Результат пустой или неопределен

Процедура прерывается по условию
Норма

Дальнейший код не выполняется

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

Обработка продолжается после ошибки

Типичные ошибки

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

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

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

Альтернативы и выбор подхода

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

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

Итог

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

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

Можно ли использовать Возврат без выражения в функции?

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

Что будет с кодом после оператора Возврат?

Строки, следующие за оператором в той же ветке выполнения, не будут выполнены. Управление передается обратно в вызывающий код.

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

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

В чем разница между оператором Возврат и документами возврата товаров?

Оператор относится к языку программирования 1C и управляет выполнением кода. Документы возврата относятся к учетным операциям с товарами и имеют другое назначение.