0

Функция СтрШаблон()

Формирует строку по заданному шаблону

Синтаксис

Функция СтрШаблон() имеет следующий синтаксис:

Строка СтрШаблон(Шаблон, [Значение1,.., Значение10])

А также альтернативный англоязычный синтаксис:

string StrTemplate(Template, [Value1,..,Value10])

Параметры

Описание параметров функции СтрШаблон():

Имя параметра* Тип Описание
Шаблон Строка Содержит шаблон конечной строки. Шаблон может состоять из обычного текста и параметров, которые начинаются с подстановочного знака % (процента)
Значение1,..,Значение10 Строка Подстановочные значения. Максимальное количество параметров = 10
*Жирным шрифтом выделены обязательные параметры

Возвращаемое значение

Строка — Строка шаблона с подставленными параметрами.

Описание

Функция СтрШаблон() формирует конечную строку, путем подстановки строковых представлений фактических параметров в указанные места шаблона. Шаблон может состоять из текста и параметров. Каждый параметр начинается с подстановочного знака %(процент), за которым следует порядковый номер параметра. Нумерация параметров начинается с 1. Если количество параметров в шаблоне не совпадает с количеством фактически переданных параметров, будет сгенерировано исключение: «Недостаточно фактических параметров» или «Очень много параметров».

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

Доступность

Версия Поддержка
8.1 не поддерживается!
8.2 не поддерживается!
8.3.6+ Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение
Внимание! В том случае, если Вы используете релиз платформы 1С:Предприятие 8.3.5 и ниже (либо аналогичный режим совместимости конфигурации), функция работать не будет. При попытке сохранить модуль вы получите ошибку: «Функция СтрШаблон() не определена!»

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

Пример кода с использованием функции СтрШаблон():

Номенклатура = "Стол деревянный";
Характеристика = "Цвет: белый";

Стр = СтрШаблон("Товар: %1, %2 не найден!", Номенклатура, Характеристика);
Сообщить(Стр);
//Результат:
//	Товар: Стол деревянный, Цвет: белый не найден!

Стр = СтрШаблон("Скидка составила %1%%", 10);
Сообщить(Стр);
//Результат:
//	Скидка составила 10%

Поделиться страницей в соц.сетях

Метки: Метки

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *