Как задать функцию в 1С: от синтаксиса до практического применения

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

Эта статья не просто объяснит базовый синтаксис — мы разберём как правильно структурировать функции для разных версий платформы (8.3 и 9.0), где их хранить (в модулях объектов, общих модулях или формах), и как избежать типичных ошибок при работе с контекстом выполнения. А ещё вы узнаете, почему иногда проще написать процедуру вместо функции, и как это влияет на производительность.

Что такое функция в 1С и чем она отличается от процедуры

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

• 📌 Процедура выполняет действия (например, сохраняет документ или обновляет справочник), но не возвращает результат.
• 🔄 Функция не только выполняет код, но и обязательно возвращает значение с помощью оператора Возврат.

Пример: если вам нужно рассчитать скидку для клиента, логичнее использовать функцию — она вернёт итоговую сумму. А если требуется просто отправить email-уведомление, подойдёт процедура.

Важно понимать, что в 1С 8.3 функции могут быть:

• 📁 Локальными — объявленными внутри другой процедуры/функции (доступны только там).
• 🌍 Глобальными — в общих модулях (доступны из любого места конфигурации).
• 📄 Модульными — в модулях объектов (например, в модуле документа РеализацияТоваровУслуг).

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

Базовый синтаксис функции в 1С выглядит так:

Функция ИмяФункции(Параметр1, Параметр2) Экспорт
// Тело функции
Возврат Результат;
КонецФункции

Разберём по частям:

• 🔹 Функция — ключевое слово, обязательное для объявления.
• 🔹 ИмяФункции — произвольное имя (регистр не важен, но лучше придерживаться CamelCase или PascalCase).
• 🔹 (Параметр1, Параметр2) — список параметров через запятую (может быть пустым).
• 🔹 Экспорт — необязательный модификатор, делает функцию доступной для вызова из других модулей.
• 🔹 Возврат — оператор, который возвращает результат (без него функция вернёт Неопределено).

Пример функции, рассчитывающей НДС:

Функция РассчитатьНДС(Сумма, Ставка = 20) Экспорт
Если Ставка = 0 Тогда
Возврат 0;
КонецЕсли;
Возврат Сумма * Ставка / 100;
КонецФункции

Чтобы вызвать эту функцию из другого места, используйте:

НДС = РассчитатьНДС(1000, 10); // Вернёт 100

Где хранить функции: общие модули vs модули объектов

Выбор места для функции зависит от её назначения. Рассмотрим основные варианты:

Пример размещения в общем модуле:

// В общем модуле "Утилиты"
Функция ПолучитьТекущийФилиал() Экспорт
Возврат ТекущийПользователь().Филиал;
КонецФункции

А так — в модуле документа:

// В модуле документа "РеализацияТоваровУслуг"
Функция ПроверитьМинимальнуюСумму()
Если СуммаДокумента() < 1000 Тогда
Возврат Ложь;
КонецЕсли;
Возврат Истина;
КонецФункции

Параметры функций: значения, ссылки и параметры по умолчанию

В 1С параметры функций могут передаваться:

• 📦 По значению (копия данных) — изменения внутри функции не влияют на исходную переменную.
• 🔗 По ссылке (с использованием ключевого слова Перем) — функция может изменить исходную переменную.

Пример передачи по ссылке:

Функция УвеличитьНа10(Перем Число)
Число = Число + 10;
КонецФункции

// Вызов:
А = 5;
УвеличитьНа10(А);
// Теперь А = 15

Также в 1С 8.3+ поддерживаются параметры по умолчанию:

Функция Приветствие(Имя = "Гость", Язык = "Русский")
Если Язык = "Русский" Тогда
Возврат "Привет, " + Имя + "!";
Иначе
Возврат "Hello, " + Имя + "!";
КонецЕсли;
КонецФункции

// Вызов без параметров:
Сообщение = Приветствие(); // "Привет, Гость!"

Типичные ошибки при работе с функциями и как их избежать

Даже опытные разработчики иногда сталкиваются с проблемами. Вот наиболее частые:

⚠️ Внимание: Если функция объявлена с модификатором Экспорт, но не добавлена в список экспортируемых методов общего модуля (в свойствах модуля), она не будет видна из других мест конфигурации.

• 🚫 Забытый Возврат — функция возвращает Неопределено, что ломает логику.
• 🔄 Рекурсия без условия выхода — приводит к переполнению стека (ошибка "Превышено максимальное число вложенных вызовов").
• 📌 Использование глобальных переменных — функции становятся зависимыми от контекста, что усложняет тестирование.
• 🔍 Длинные функции — если функция занимает более 30-40 строк, её лучше разбить на несколько smaller.

Пример ошибочной рекурсии:

Функция БесконечныйВызов()
БесконечныйВызов(); // Нет условия выхода!
КонецФункции

Исправленный вариант:

Функция Факториал(Число)
Если Число = 1 Тогда
Возврат 1;
КонецЕсли;
Возврат Число * Факториал(Число - 1);
КонецФункции

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

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

1. 🛠 Кэширование результатов — если функция часто вызывается с одинаковыми параметрами, сохраняйте результат в статической переменной:

Функция ПолучитьКурсВалюты(Валюта, Дата)
Статическая Кэш;
Если Кэш = Неопределено Тогда
Кэш = Новый Соответствие;
КонецЕсли;
Ключ = Валюта.УникальныйИдентификатор() + "|" + Формат(Дата, "ДЛФ=DT");
Если Кэш.СодержитКлюч(Ключ) Тогда
Возврат Кэш[Ключ];
КонецЕсли;
Курс = ПолучаемКурсИзБазы(Валюта, Дата); // Ваша логика
Кэш.Вставить(Ключ, Курс);
Возврат Курс;
КонецФункции

2. 📊 Разделение логики — одна функция должна делать одно действие. Например, вместо:

Функция ОбработатьЗаказ(Заказ)
// 1. Проверка данных
// 2. Расчёт суммы
// 3. Сохранение в базу
// 4. Отправка email
...
КонецФункции

Лучше разбить на 4 отдельные функции и вызывать их последовательно.

3. ⚡ Избегайте тяжелых операций — не размещайте внутри функций запросы к базе, если их можно вынести наружу и передавать готовые данные.

Практический пример: функция для работы с JSON в 1С

Рассмотрим реальный случай — функцию, которая преобразует таблицу значений в JSON-строку. Это актуально для интеграций с веб-сервисами.

Функция ТаблицаВJSON(Таблица) Экспорт
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.ЗаписатьНачалоМассива();

Для Каждого Строка Из Таблица Цикл
ЗаписьJSON.ЗаписатьНачалоОбъекта();
Для Каждого Колонка Из Таблица.Колонки Цикл
ЗаписьJSON.ЗаписатьИмяСвойства(Колонка.Имя);
ЗаписьJSON.ЗаписатьЗначение(Строка[Колонка.Имя]);
КонецЦикла;
ЗаписьJSON.ЗаписатьКонецОбъекта();
КонецЦикла;

ЗаписьJSON.ЗаписатьКонецМассива();
Возврат ЗаписьJSON.Закрыть();
КонецФункции

Вызов:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Наименование");
ТЗ.Колонки.Добавить("Цена");
ТЗ.Добавить();
ТЗ[0].Наименование = "Товар 1";
ТЗ[0].Цена = 100;

JSONСтрока = ТаблицаВJSON(ТЗ);
// Результат: [{"Наименование":"Товар 1","Цена":100}]

⚠️ Внимание: При работе с большими таблицами (>10 000 строк) такая функция может тормозить. В этом случае лучше использовать потоковую запись или разбивать данные на части.

FAQ: ответы на частые вопросы о функциях в 1С

Функция СуммаЧисел(Числа)
Результат = 0;
Для Каждого Число Из Числа Цикл
Результат = Результат + Число;
КонецЦикла;
Возврат Результат;
КонецФункции

// Вызов:
Сумма = СуммаЧисел(Новый Массив(1, 2, 3, 4));

Функция РазделитьФИО(ФИО)
Данные = Новый Структура;
Части = СтроковыеФункции.РазделитьСтроку(ФИО, " ");
Данные.Вставить("Фамилия", Части[0]);
Данные.Вставить("Имя", Части[1]);
Данные.Вставить("Отчество", Части[2]);
Возврат Данные;
КонецФункции

Процедура ИзменитьТаблицу(ТЗ)
ТЗ.Добавить();
ТЗ[ТЗ.Количество() - 1].Наименование = "Новая строка";
КонецПроцедуры

// Вызов:
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Наименование");
ИзменитьТаблицу(Таблица);
// Теперь в Таблица есть новая строка