0

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

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

Синтаксис

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

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

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

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

Параметры

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

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

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

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

Описание

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

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

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

Доступность

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер).

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

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

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

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

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

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

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