Другое · 8 мин
Что лучше в 1С: функция или процедура
Разница между функцией и процедурой в 1С: когда возвращать результат, а когда выполнять действие, параметры, ограничения и типичные ошибки.
В конфигурациях 1С:Предприятия встроенный язык предлагает два основных вида подпрограмм: процедуру и функцию. Внешне они выглядят похоже: оба описываются в модуле, принимают параметры и могут быть экспортированы. Главное различие не в синтаксисе объявления, а в том, что делает код после вызова и как результат используется дальше.
Процедура выполняет действие и не возвращает значение вызывающему коду. Её вызывают как отдельную инструкцию, когда нужно изменить данные, открыть форму, записать документ или вывести сообщение. Функция вычисляет результат и возвращает его через оператор Возврат, поэтому её можно встроить в выражение, условие или присвоить переменной.
Выбор между ними определяется задачей, а не привычкой. Если нужно только совершить действие, подходит процедура; если нужно получить значение для дальнейших расчётов, — функция. Смешивание ролей приводит к трудночитаемому коду и ошибкам при повторном использовании.
Чем функция отличается от процедуры
Процедура объявляется ключевым словом Процедура и завершается КонецПроцедуры. Она вызывается отдельной строкой, и после её выполнения управление просто возвращается к следующей инструкции. Явного результата у вызова нет, хотя процедура может изменять переданные объекты, записи в базе или состояние интерфейса.
Функция объявляется через Функция и обязательно содержит хотя бы один оператор Возврат с выражением. Её результат можно использовать сразу: записать в переменную, подставить в условие Если, передать в другой вызов или вывести на форму. Если код функции не достигает Возврат на каком-то из путей выполнения, это считается нарушением логики и может привести к неопределённому поведению.
Обе подпрограммы могут быть экспортированы ключевым словом Экспорт, что делает их видимыми из других модулей конфигурации. Обе поддерживают параметры, локальные переменные и рекурсию. Разница остаётся в одном: процедура — для действия, функция — для получения значения.
Сравнение вариантов
Подходит для команд, обработчиков событий, записи данных и действий без возвращаемого значения. Не может использоваться напрямую в выражении.
Подходит для расчётов, проверок, формирования строк и значений, которые нужны дальше по коду. Обязательно возвращает результат.
Когда использовать процедуру
Процедура уместна, когда цель кода — изменить что-то, а не вычислить. Типичные примеры: запись документа, проведение движения, открытие формы, отправка уведомления, заполнение табличной части, вызов внешней команды. В таких случаях вызывающий код не ждёт ответа, ему важно само действие.
Процедура как обработчик команды или события
Особое преимущество процедуры — возможность назначить её обработчиком команды формы, события элемента управления или бизнес-события конфигурации. Функцию напрямую в такую роль поставить нельзя, поэтому для реакции на действия пользователя выбирают процедуру.
Действия с побочными эффектами
Если подпрограмма меняет значения реквизитов, пишет в регистры, создаёт документы или вызывает модальное окно, процедура является более честным описанием намерения. Читающий код сразу понимает: здесь происходит изменение состояния, а не вычисление.
Когда использовать функцию
Функция необходима, когда результат должен участвовать в дальнейшей логике. Примеры: расчёт скидки, проверка заполнения обязательных реквизитов, формирование наименования, преобразование даты, вычисление суммы по табличной части. Вызов функции встраивается в выражение, и программа продолжает работу с полученным значением.
Функции удобны для повторного использования в разных модулях. Один раз описав функцию расчёта налога или проверки остатка, можно вызывать её из обработок, отчётов и форм, не дублируя формулу. Это упрощает поддержку: изменение логики в одном месте обновляет все места вызова.
Однако функция не должна иметь сильных побочных эффектов. Если функция одновременно вычисляет значение и записывает документ, код становится трудно предсказуемым. Лучше разделить ответственность: функция считает, процедура пишет.
Параметры, видимость и контекст выполнения
И процедуры, и функции принимают параметры. В языке 1С параметры передаются по значению, но объекты и ссылки ведут себя так, что изменения внутри подпрограммы могут отражаться на исходном объекте. Нужно учитывать это, чтобы не изменить данные случайно.
Экспортные процедуры и функции видны из других модулей, неэкспортные — только внутри своего модуля. При вызове на сервере или клиенте важно соблюдать контекст: процедура или функция, помеченная для сервера, не будет вызвана из клиентского обработчика без соответствующей обёртки.
Область видимости локальных переменных ограничена телом подпрограммы. Переменные, объявленные внутри функции или процедуры, не доступны снаружи, что снижает риск случайных конфликтов имён.
Ограничения и типичные ошибки
Частая ошибка — вызывать функцию как отдельную инструкцию и игнорировать её результат. Тогда вычисление выполняется, но значение пропадает, а код выглядит как процедура. Обратная ошибка — пытаться использовать процедуру в выражении, например присвоить её результат переменной. Такой код не скомпилируется.
Ещё одна ошибка — функция без Возврат на всех ветках условия. Если одна ветка возвращает значение, а другая нет, поведение становится неопределённым. Процедура может использовать пустой Возврат для преждевременного выхода, а функция должна всегда возвращать значение соответствующего типа.
Не стоит делать функции слишком длинными или заставлять их одновременно считать и менять данные. Сложные функции трудно тестировать, а процедуры с множеством побочных эффектов трудно переносить между конфигурациями.
- 1Определите цель подпрограммы: действие или вычисление.
- 2Если нужен результат — создайте функцию с Возврат на всех путях.
- 3Если результата нет — создайте процедуру.
- 4Проверьте, не нужна ли подпрограмма как обработчик команды формы — тогда выбирайте процедуру.
- 5Убедитесь, что функция не меняет данные внезапно для вызывающего кода.
Как выбрать: порядок действий
Прежде чем писать подпрограмму, ответьте на вопрос: нужен ли вызывающему коду результат после завершения. Если нет — оформляйте процедуру. Если да — оформляйте функцию и продумайте все ветки возврата.
Также учитывайте место вызова. Для команды формы или события элемента управления подойдёт только процедура. Для формулы в отчёте, вычисления в запросе или проверки в условии — функция. Если роль неочевидна, начните с процедуры, а при необходимости получения результата переделайте её в функцию.
Контрольные точки перед публикацией кода
Проверьте, что функция возвращает значение на каждой ветке выполнения, а процедура не вызывается в выражении. Убедитесь, что параметры не изменяются непреднамеренно, особенно при работе с табличными частями и объектами справочников. Протестируйте подпрограмму в изолированном обработке перед переносом в основной модуль.
Безопасная самостоятельная работа возможна при создании обычных подпрограмм в стандартных модулях конфигурации. Осторожность требуется при изменении серверных вызовов, работы с регистрами накопления и бухгалтерии, а также при правке обработчиков проведения документов — ошибки здесь могут повредить данные.
Что важно запомнить
Процедура для действий, функция для возврата значения; не смешивайте роли, проверяйте все ветки Возврат и учитывайте контекст вызова.
Можно ли вызвать функцию как процедуру, не используя результат?
Технически вызов функции как отдельной инструкции возможен, но возвращаемое значение будет проигнорировано. Такой код плохо читается и создаёт впечатление, что функция используется как процедура. Если результат не нужен, лучше переписать подпрограмму как процедуру.
Может ли процедура вернуть значение?
Нет, процедура не возвращает значение вызывающему коду. Она может использовать оператор Возврат без выражения только для преждевременного выхода. Если нужно получить результат, оформляйте код как функцию.
Что выбрать для обработчика команды формы?
Только процедуру. Обработчики команд и событий элементов управления не поддерживают функции напрямую, так как от них не требуется возвращаемое значение.
Нужна ли функция для расчёта, который используется в одном месте?
Да, если результат участвует в дальнейших вычислениях или условиях. Даже однократное использование не отменяет преимущества функции: код становится яснее, а логика вычисления отделена от действий.
Что делать, если подпрограмма и считает, и записывает данные?
Разделите её на две части: функцию для расчёта и процедуру для записи. Так код легче тестировать, повторно использовать и поддерживать, а вызывающий код явно видит, где вычисление, а где изменение данных.