Как вернуть значение из функции в 1С Предприятие

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

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

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

Синтаксис объявления функции и оператора возврата

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

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

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

⚠️ Внимание: Если вы забудете указать оператор Возврат в теле функции, платформа 1С не выдаст ошибку компиляции, но в точку вызова вернется значение Неопределено. Это частая причина логических ошибок, когда программа продолжает работать, но получает «пустоту» вместо ожидаемого числа или строки.

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

Функция ВычислитьПлощадь(Длина, Ширина)
Площадь = Длина * Ширина;
Возврат Площадь;
КонецФункции

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

Отличия функций от процедур в контексте возврата данных

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

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

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

• 🔹 Процедура используется для изменения состояния системы без получения результата.
• 🔹 Функция используется для вычислений и получения данных для дальнейшей обработки.
• 🔹 Оператор Возврат в функции передает данные, в процедуре — только прерывает выполнение.

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

Работа с типами данных при возврате результата

Язык запросов и программирования 1С является типизированным, но тип возвращаемого значения функции не объявляется явно в сигнатуре. Это означает, что одна и та же функция теоретически может вернуть число в одном случае и строку в другом, однако это крайне не рекомендуется.

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

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

Тип данных	Пример возврата	Рекомендация по использованию
Число	Возврат 100;	Для расчетов, количеств, сумм.
Строка	Возврат "Ошибка";	Для сообщений, кодов, имен.
Булево	Возврат Истина;	Для флагов успеха/провала.
Ссылка	Возврат Справочники.Номенклатура.НайтиПоНаименованию(...);	Для передачи объектов базы данных.

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

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

Особенности возвращения массивов и структур

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

Досрочный выход из функции и множественные возвраты

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

Это позволяет избежать глубокой вложенности условий (так называемого «адского кода» или spaghetti code). Вместо того чтобы помещать основной код внутрь множества проверок Если ... Тогда, вы можете сразу возвращать значение при неудаче.

Функция ПроверитьДоступ(Пользователь)
Если Пользователь = Неопределено Тогда
Возврат Ложь;
КонецЕсли;

Если Пользователь.Заблокирован Тогда
Возврат Ложь;
КонецЕсли;

// Основной код проверки
Возврат Истина;
КонецФункции

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

Однако стоит помнить о мере. Слишком большое количество точек выхода из функции (более 3-4) может запутать разработчика при отладке. В сложных алгоритмах лучше стремиться к единой точке выхода в конце функции, используя промежуточные переменные-флаги.

Возврат значений по ссылке и модификация параметров

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

Однако, если необходимо изменить исходную переменную, используется модификатор Знач (для передачи копии) или его отсутствие в сочетании с объектными типами. Но важно понимать: простые типы (Число, Строка, Дата) всегда ведут себя как значения, а объекты (СправочникСсылка, ДокументОбъект) передают ссылку на объект.

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

• 🔸 Простые типы возвращаются копией значения.
• 🔸 Объектные типы возвращают ссылку на объект в базе.
• 🔸 Для возврата нескольких разнородных значений используйте Структуру.

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

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

Типичные ошибки и лучшие практики

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

Еще одна частая проблема — игнорирование возвращаемого значения функции, когда оно критически важно. Например, функция Записать() у многих объектов возвращает булево значение (успешно или нет). Если вы не проверяете этот результат, ваша программа может продолжить работу с незарегистрированными данными.

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

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

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

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

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

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

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

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

Как вернуть таблицу значений из функции?

Таблица значений — это полноценный объект в 1С. Вы можете создать её внутри функции, заполнить строками и вернуть командой Возврат Таблица. Вызывающий код получит ссылку на эту таблицу и сможет с ней работать.

Обязательно ли указывать тип возвращаемого значения?

В языке 1С нет строгой декларации типа возвращаемого значения в сигнатуре функции. Тип определяется динамически в момент выполнения. Однако для качества кода рекомендуется всегда возвращать данные одного ожидаемого типа.