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