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

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

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

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

Основное концептуальное различие

Главным и определяющим отличием функции от процедуры в языке 1С является наличие возвращаемого значения. Функция всегда обязана вернуть какой-то результат после завершения своей работы. Этот результат может быть любого типа: числом, строкой, ссылкой на объект, массивом или даже Неопределено.

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

С точки зрения математики функцию можно сравнить с уравнением y = f(x), где на вход подается аргумент, а на выходе получается значение. Процедура же больше напоминает команду в операционной системе, которая запускает процесс, но не обязательно сообщает о его итоговом численном значении.

Синтаксические особенности объявления

При написании кода в модулях 1С синтаксис объявления подпрограмм четко диктует их тип. Ключевые слова Функция и Процедура задают тон всему последующему блоку кода. Компилятор платформы строго следит за соответствием объявления и тела подпрограммы.

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

Функция РассчитатьНДС(Сумма)
Результат = Сумма * 0.20;
Возврат Результат;
КонецФункции

Процедура ВывестиСообщение(Текст)
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = Текст;
Сообщение.Сообщить;
КонецПроцедуры

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

Механизм возврата значений и переменные

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

Процедуры не могут участвовать в выражениях. Вы не можете написать условие Если МояПроцедура Тогда..., так как процедура не имеет значения истинности или ложности в контексте выражения. Для передачи данных из процедуры используются параметры, передаваемые по ссылке (ключевое слово Знач не используется или используется специфически для модификации).

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

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

Тонкости передачи параметров

Если вы объявите параметр процедуры как Знач Параметр, то внутри процедуры создается копия переменной. Изменения внутри процедуры не повлияют на исходную переменную. Без слова Знач передается ссылка на саму переменную.

Области видимости и контекст выполнения

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

Для того чтобы вызвать подпрограмму из другого модуля (например, из формы документа вызвать функцию из общего модуля), необходимо добавить ключевое слово Экспорт в объявление. Без этого слова попытка внешнего вызова приведет к ошибке"Модуль не содержит экспортной процедуры/функции".

Характеристика	Процедура	Функция
Возврат значения	Нет	Обязательно
Использование в выражениях	Запрещено	Разрешено
Ключевое слово выхода	Возврат (опционально)	Возврат (обязательно)
Назначение	Действие/Изменение состояния	Вычисление/Получение данных

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

Сценарии использования в разработке 1С

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

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

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

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

Производительность и оптимизация кода

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

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

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

Частые ошибки начинающих разработчиков

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

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

• 🔸 Ошибочное использование процедуры в выражении присваивания.
• 🔸 Отсутствие оператора Возврат в теле функции.
• 🔸 Изменение глобальных переменных внутри функции вместо возврата значения.
• 🔸 Игнорирование возвращаемого значения функции (вызов функции как процедуры).

Также стоит упомянуть ошибку игнорирования возвращаемого значения. Если функция что-то рассчитывает, но вы вызываете ее просто как МояФункция(Параметр); без присваивания, вы тратите ресурсы процессора впустую. Исключение составляют функции, названные как действия (например, ОчиститьКэш), но это плохой тон нейминга.

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

Рекомендации по именованию и стилю

Соблюдение соглашений об именовании (Code Style) критически важно для поддержки кода в 1С. Название подпрограммы должно сразу говорить о ее типе и назначении. Для функций обычно используют отглагольные существительные или инфинитивы, подразумевающие результат: ПолучитьСписок, РассчитатьСумму.

Для процедур уместны глаголы в повелительном наклонении или действия: ЗаписатьОбъект, ОткрытьФорму, УстановитьФлажок. Такое разделение помогает разработчику мгновенно понять, вернет ли подпрограмма данные или просто совершит действие.

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

Совет по рефакторингу

Если ваша процедура стала слишком длинной (более 50-70 строк), попробуйте выделить из нее части, которые возвращают промежуточные результаты, в отдельные функции. Это упростит тестирование каждой части по отдельности.

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

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

В чем разница между параметром со словом"Знач" и без него?

Ключевое слово Знач означает передачу параметра по значению (создается копия). Изменения внутри подпрограммы не затронут исходную переменную. Без этого слова (по умолчанию для объектов) передается ссылка, и изменения внутри подпрограммы повлияют на исходный объект.

Обязательно ли использовать слово"Экспорт" для всех функций?

Нет. Слово Экспорт нужно только тогда, когда вы планируете вызывать эту функцию или процедуру из другого модуля. Если логика используется только внутри текущего модуля (например, в модуле формы), слово Экспорт не требуется и даже не рекомендуется для инкапсуляции.

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

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

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

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