Format

function Format(const Fmt: String; Args: array of const): String -DESKTOP- -WEB-

Форматирует строку в соответствии с шаблоном. Шаблон представляет собой текст с заполнителями, вместо которых подставляются элементы массива Args. Заполнители имеют следующий синтаксис:

%[Index:][-][Width][.Precision]Type
  • % - начало заполнителя. Для вставки знака процента, он просто дублируется: %%.
  • Index - индекс элемента массива Args, который должен быть вставлен в текст. Если индекс не указан, берется нулевой аргумент.
  • - сообщает функции о выравнивании вставленного текста по левому краю. По умолчанию вставленный текст выравнивается по правому краю. Это может вступить в силу только в том случае, если также указан параметр Width.
  • Width - вставленная строка должна содержать не менее Width символов. В противном случае вставленная строка будет дополнена пробелами. По умолчанию строка дополняется слева, в результате получается строка с выравниванием по правому краю. Это поведение можно изменить с помощью символа -.
  • Precision - указывает точность, которая будет использоваться при преобразовании аргумента. Точность зависит от типа.
  • Type - тип аргумента.

Параметры Index, Width и Precision можно заменить на *, и в этом случае их значение будет считано из следующего элемента в массиве Args . Это значение должно быть целым числом, иначе возникнет исключение.

Type представляет собой один из следующих символов (без учета регистра):

  • d - десятичное (целое число). Следующим аргументом в массиве Args должно быть целое число. Аргумент преобразуется в десятичную строку. Если указана точность, то строка будет содержать как минимум цифры точности . При необходимости строка (слева) дополняется нулями.
  • e - научный формат. Следующим аргументом в массиве Args должно быть значение с плавающей запятой. Аргумент преобразуется в десятичную строку с использованием экспоненциальной записи, где необязательная точность используется для указания общего количества десятичных знаков. (по умолчанию используется значение 15). Показатель степени форматируется максимум из 3 цифр.
  • f - фиксированное. Следующим аргументом в массиве Args должно быть значение с плавающей запятой. Аргумент преобразуется в десятичную строку с использованием фиксированной записи. Точность указывает количество цифр после десятичной точки.
  • g - общий числовой формат. Следующим аргументом в массиве Args должно быть значение с плавающей запятой. Аргумент преобразуется в десятичную строку с использованием нотации с фиксированной запятой или экспоненциальной нотации, в зависимости от того, что дает самый короткий результат. Точность используется для определения количества цифр после десятичной точки.
  • m - деньги. Следующий аргумент в массиве Args должен быть значением с плавающей запятой. Аргумент преобразуется в десятичную строку с использованием денежной записи. Это означает, что используется запись с фиксированной точкой, но к нему добавляется символ валюты.
  • n - число (плавающее). Это то же самое, что и формат с фиксированной точкой (f), за исключением того, что в результирующую строку вставляются разделители тысяч.
  • p - указатель. Следующим аргументом в массиве Args должен быть указатель. Значение указателя преобразуется в строку длиной 8, представляющую шестнадцатеричное значение указателя.
  • s - строка. Следующим аргументом в массиве Args должна быть строка. Аргумент просто копируется в строку результата. Если указана точность , то в строку результата копируются только символы точности.
  • u - десятичное число без знака. Следующим аргументом в массиве Args должно быть целое число без знака. Аргумент преобразуется в десятичную строку. Если указана точность, то строка будет содержать как минимум цифры точности . При необходимости строка (слева) дополняется нулями.
  • x - шестнадцатеричный формат. Следующий аргумент в массиве Args должен быть целым числом. Аргумент преобразуется в шестнадцатеричную строку с количеством символов ровно столько, чтобы содержать значение целого числа. Если указана точность, то результирующее шестнадцатеричное представление будет содержать не менее символов точности (максимальное значение 32).

На форматирование влияют глобальные настройки форматирования.

В случае ошибок в шаблоне срабатывает исключение. Возможные ошибки:

  1. Ошибки в спецификаторах формата.
  2. Следующий аргумент не того типа, который требуется спецификатору.
  3. Количество аргументов не подходит для всех спецификаторов формата.

Параметры:

  • Fmt - шаблон.
  • Args - аргументы.

Пример: Format

Ссылки: GetFormatSettings, SetFormatSettings