Site Logo

format

Группа: Функции работы со строками

Платформы: t1000

Синтаксис

<format: <pattern>, ...>

Параметры

  • pattern - Строка составного формата
  • ... - Определенное строкой формата число аргументов

Описание

Формирует строку в соответствии с полученной строкой формата и аргументами. В качестве входных данных для составного формирования используется список объектов и строка составного формата. Строка составного формата состоит из фиксированного текста, в который включены индексированные местозаполнители, которые называются элементами формирования и соответствуют объектам из списка. Операция форматирования создает результирующую строку, состоящую из исходного фиксированного текста, в который включено строковое представление объектов из списка. Строка составного формата состоит из блоков фиксированного текста числом от нуля и больше, перемежаемых одним или несколькими элементами формирования. Фиксированным текстом может являться произвольная строка, а каждый элемент форматирования должен соответствовать объекту или упакованной структуре из списка. Элемент форматирования имеет следующий синтаксис: {index}. Парные фигурные скобки ("{" и "}") обязательны. Параметр index — это числовая константа, определяющаю соответствующий объект из списка; индексация элементов ведется от нуля; значение не вычисляется из переменных. Иными словами, элемент формирования с индексом 0 отвечает за вставку первого объекта в списке, элемент формирования с индексом 1 служит для вставки второго объекта в списке и т. д.

  • Функция кэширует результат преобразований параметров к строкам, поэтому она оптимальнее чем concat может использоваться в случаях, когда вхождение параметра многократное.
  • Функция всегда возвращает строку, даже если не переданы аргументы и строка форматирования.

Примеры

Пример №1

Set
  ?maskedPan : "000000****0000"
  ?message : <Format: "Платеж по карте '{0}' не прошел. Заносим карту '{0}' в черный список", ?maskedPan>

Результат:

В переменной ?message будет размещен текст "Платеж по карте 000000****0000 не прошел. Заносим карту 000000****0000 в черный список".

Пример №2

Set
  ?command : {0xC2, 0xF1, 0x30, 0x90, 0x00}
  ?message : <Format: "Получена посылка {0}", ?command>

Результат:

В переменной ?message будет размещен текст "Получена посылка C2F1309000".