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

Другое · 7 мин

Как писать функции в 1С: объявление, параметры и возврат

Как создать функцию в 1С: объявление в модуле объекта и общем модуле, параметры, возврат результата, вызов и проверка, типичные ошибки и безопасная отладка.

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

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

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

Сравнение вариантов размещения

Модуль объекта

Подходит для логики, связанной с конкретным документом или справочником

Общий модуль

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

Объявление функции в модуле объекта

В модуле объекта функция описывается в разделе функций модуля. Пример простого объявления:

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

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

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

Порядок создания функции
  1. 1
    Определите место объявления: модуль объекта или общий модуль
  2. 2
    Опишите имя, параметры и флаг экспорта
  3. 3
    Напишите тело с оператором Возврат
  4. 4
    Вызовите функцию и проверьте результат

Общие модули и экспорт

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

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

Когда уместен серверный или клиентский контекст

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

Где объявлена функцияМодуль объекта или общий модуль

Проверьте область видимости и наличие экспорта

Есть ли возвратОператор Возврат

Убедитесь, что каждая ветка кода возвращает значение или явно обрабатывает отсутствие результата

Параметры и возвращаемое значение

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

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

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

Вызов функции и обработка результата

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

РазмерСкидки = РассчитатьСкидку(СуммаЗаказа, ПроцентСкидки);
Если РазмерСкидки > 0 Тогда
// обработка скидки
КонецЕсли;

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

Проверка и отладка

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

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

Типичные ошибки
01
Забыт оператор Возврат — вызывающий код получает неопределённый результат
02
Вызов неэкспортируемой функции из другого модуля — ошибка доступа
03
Передача параметров по ссылке без понимания изменения исходного значения

Частые ошибки и ограничения

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли вызвать функцию из формы документа, если она объявлена в общем модуле?

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

Что будет, если функция не вернет значение в какой-то ветке?

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

Нужно ли указывать типы параметров функции?

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

Может ли функция изменять переданный в неё объект?

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

Где лучше хранить функцию расчёта скидки: в документе или в общем модуле?

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