Процент (%) в 1С: от форматирования до арифметики — полное руководство

Символ процента (%) в языке 1С:Предприятие — это не просто знак для обозначения долей. Он выполняет сразу несколько ролей: от форматирования строк до выполнения арифметических операций. Новички часто путают его с оператором модуля из других языков программирования, а опытные разработчики используют его для оптимизации кода. В этой статье мы разберём все варианты применения % в 1С 8.3 и 1С 7.7, покажем реальные примеры и предупредим о типичных ошибках.

Особенность 1С в том, что здесь % не ограничивается математикой. Он активно используется в форматировании строк (аналог printf в C), в регулярных выражениях и даже в запросах. При этом синтаксис и поведение символа могут отличаться в зависимости от контекста. Например, в арифметических выражениях % работает как оператор остатка от деления, а в строках — как спецификатор формата. Разберёмся, где и как его правильно применять.

1. Процент как оператор остатка от деления (модуль)

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

Пример использования:

Число = 10;
Остаток = Число % 3; // Вернёт 1 (10 делим на 3, остаток 1)

Особенности работы:

• 🔢 Если делимое отрицательное, результат тоже будет отрицательным: -10 % 3 вернёт -1.
• 📉 При делении на ноль возникнет ошибка {ОшибкаПриВыполнении}.
• 🔄 Оператор работает с целыми числами и числами с плавающей запятой, но для дробных чисел лучше использовать функцию Остаток().

⚠️ Внимание: В 1С 7.7 оператор % отсутствует — вместо него используется функция Mod(). При переносе кода между версиями это может вызвать ошибки.

2. Процент в форматировании строк (аналог sprintf)

Одна из самых востребованных функций % в 1С — форматирование строк. Символ используется как спецификатор для подстановки значений в строку, аналогично функции СтрШаблон() или Format() в других языках. Это удобно для создания динамических сообщений, отчётов или логов.

Базовый синтаксис:

Сообщение = СтроковоеВыражение("%1 — это %2", "Итого", 1000); // "Итого — это 1000"

Расширенные возможности:

Пример с выравниванием и числовыми форматами:

Текст = СтроковоеВыражение("|%10s|%5d|%8.2f|", "Товар", 123, 999.999);
// Результат: "|   Товар| 123|  1000.00|"

⚠️ Внимание: Если количество спецификаторов % не совпадает с количеством аргументов, 1С не выдаст ошибку, но результат может быть некорректным. Например, "%1 %2" с одним аргументом подставит его дважды.

3. Процент в регулярных выражениях

В 1С 8.3 символ % применяется и в регулярных выражениях (регулярках) для поиска и замены текста. Здесь он имеет специальное значение — обозначает начало или конец строки в зависимости от контекста. Однако чаще всего % используется как экранирующий символ для других метасимволов.

Примеры:

• 🔍 %[а-яА-Я] — поиск любой кириллической буквы.
• 📝 СтрЗаменить(Текст, "%\d+", "") — удаление всех чисел из строки (здесь % экранирует \d).
• 🔄 РегВыражение = Новый РегВыражение("%(абв|где)"); — поиск слов "абв" или "где".

Его поведение зависит от реализации движка регулярных выражений в платформе.

4. Процент в запросах 1С (SQL-подобный синтаксис)

В языке запросов 1С символ % используется как подстановочный знак (wildcard) в операторе ПОДОБНО (аналог LIKE в SQL). Он обозначает любое количество любых символов, что удобно для фильтрации данных по шаблону.

Примеры запросов:

ВЫБРАТЬ
Наименование
ИЗ
Справочник.Номенклатура
ГДЕ
Наименование ПОДОБНО "%стол%" // Найдёт "Стол дубовый", "Офисный стол" и т.д.

Особенности:

• 📌 % в начале шаблона ("%текст") — поиск по окончанию.
• 📌 % в конце ("текст%") — поиск по началу.
• 📌 %текст% — поиск по вхождению.
• 🚫 Для поиска самого символа % используйте ПОДОБНО "%\%" (экранирование).

⚠️ Внимание: Оператор ПОДОБНО чувствителен к регистру в некоторых конфигурациях. Для регистронезависимого поиска используйте ВРЕГ() или настройки коллации.

5. Типичные ошибки при использовании % в 1С

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

1. Путаница с оператором модуля. В 1С 7.7 нет оператора % — вместо него используется функция Mod(). Попытка использовать % в старой версии приведёт к синтаксической ошибке.
2. Несовпадение количества спецификаторов. В СтроковоеВыражение("%1 %2", "А") второй спецификатор останется незаполненным, но ошибки не будет.
3. Экранирование в регулярках. Забывают удвоить % при поиске самого символа: %%.
4. Деление на ноль. Оператор % в арифметике не проверяет делитель на ноль — это приводит к падению программы.

Критическая ошибка: использование % в строках без экранирования может привести к уязвимостям инъекций, если данные поступают от пользователя. Всегда проверяйте входные параметры перед подстановкой в СтроковоеВыражение() или запросы.

Используется ли % в правильном контексте (арифметика/строки/регулярки)?

Совпадает ли количество спецификаторов с количеством аргументов?

Экранированы ли специальные символы в регулярках?

Проверен ли делитель на ноль в арифметических операциях?

-->

6. Примеры практического применения % в 1С

Рассмотрим реальные задачи, где % незаменим:

Пример 1: Форматирование чека для ККМ

ТекстЧека = СтроковоеВыражение(
"%-20s %6.2f руб.

ИТОГО: %8.2f руб.",
"Хлеб бородинский", 56.30,
56.30
);

Пример 2: Проверка чётности в цикле

Для Сч = 1 По 10 Цикл
Если Сч % 2 = 0 Тогда
Сообщить(Сч + " — чётное");
КонецЕсли;
КонецЦикла;

Пример 3: Поиск документов по шаблону

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|  Номер, Дата
|ИЗ
|  Документ.ЗаказПокупателя
|ГДЕ
|  Номер ПОДОБНО "%" + НомерШаблона + "%"";

Пример 4: Разбиение данных на группы

Группа = Данные.Количество % 10; // Разбиваем на группы по 10 элементов

7. Альтернативы символу % в 1С

В некоторых случаях % можно заменить другими конструкциями:

Пример с СтрШаблон():

Текст = СтрШаблон("Клиент: %1, Сумма: %2", Клиент.Наименование, Документ.Сумма);

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

ДатаТекст = Формат(ТекущаяДата(), "ДФ='dd.MM.yyyy'");

Сообщить(СтрШаблон("Скидка %1%%", 50)); // Выведет "Скидка 50%"

Результат1 = -10 % 3;  // -1
Результат2 = Остаток(-10, 3); // 2

Формат(Сумма, "%10.2f");