Сформировать строку по фиксированному шаблону.
Синтаксис:
ФиксШаблон(<Строка_шаблон>)
Англоязычный синоним:
FixTemplate
Параметры:
<Строка_шаблон> |
Строковое выражение, содержащее шаблон формирования результирующей строки. |
Возвращаемое значение:
Строковое значение.
Описание:
Функция ФиксШаблон возвращает строковое значение, сформированное в соответствии с заданным параметром <Строка_шаблон>, заменив в ней все встроенные выражения, заключенные в квадратные скобки, на их значения. В отличие от функции Шаблон, поля замещаются значениями выражений с сохранением своей длины в символах, то есть обрезаются, если поле короче результата вычисления выражения и дополняются пробелами если длиннее. Если результат числовой, то в границах поля строка прижимается к правой границе.
Строковое значение параметра <Строка_шаблон> обрабатывается следующим образом: символы "[" , "]" (квадратные скобки) являются специальными символами, которые выделяют поля, содержащие встроенные выражения. Выделенные поля фиксируют свою длину с учетом ограничивающих скобок. Например:
Имя Клиента [Имя], телефон: [Телефон]
После встроенного выражения может стоять символ "#", после которого следует Форматная_строка описанная в функции Формат. В этом случае в данное поле будет проставлен результат выражения, обработанный функцией Формат.
Пример:
// ниже - пример с дополнением пробелами
Стр = Шаблон("Это название услуги [Услуга.Наименование ]");
// выдает: "Это название услуги Вывоз мусора "
// далее - с сокращением строки
Стр = Шаблон("Это название услуги [Услуга.Наименование]");
// выдает: "Это название услуги Выполенние формирован"
Установить флаг добавления строк по фиксированному шаблону.
Синтаксис:
ФиксШаблон(<Флаг>)
Англоязычный синоним:
FixTemplate
Параметры:
<Флаг> |
Числовое выражение: 1 — установить флаг добавления строк по фиксированному шаблону, 0 — снять флаг. |
Возвращаемое значение:
Текущее числовое значение флага добавления строк по фиксированному шаблону (на момент до исполнения метода).
Описание:
Метод ФиксШаблон устанавливает флаг при котором все добавления строк в текст выполняются с заменой полей ограниченных квадратными скобками на значения содержащихся в них выражений (см. гл. «Системные процедуры и функции», функция ФиксШаблон).
В отличие от метода Шаблон, ограниченные квадратными скобками поля замещаются значениями выражений с сохранением своей длины в символах, то есть обрезаются, если поле короче результата вычисления выражения и дополняются пробелами если длиннее. Если результат числовой, то в границах поля строка прижимается к правой границе.
Пример:
ТекстДок = СоздатьОбъект("Текст");
ТекстДок.Открыть("catalog.txt");
ТекстДок.ФиксШаблон(1);
ТекстДок.ЗаменитьСтроку(52, "[Услуга.Наименование],
арт.[Услуга.Код]......[Услуга.Цена]");
ТекстДок.Шаблон(0);
ТекстДок.ВставитьСтроку(53, "Вывоз мусора, 6321, 58.000");
ТекстДок.ТолькоПросмотр(1);
См. также: «Системные процедуры и функции», функция ФиксШаблон