Программирование: Format

Прототип

function Format(const Format: String; const Args: array of const): String;

Описание

Форматирует в указанной строке Format последовательность простых типов данных из массива Args (список аргументов). Форматирование управляется строковым форматом функции и результат возвращается в виде преобразованной строки.

В простых условиях каждые данные (спецификаторы формата), форматирующие подстроку, начинаются знаком % и заканчиваются индикатором типа данных:

d = Десятичный (целое число)
e = Научный
f = Фиксированный
g = Генерал
m = Денежный
n = Числовой (с плавающей точкой)
p = Указатель
s = Строковый
u = Десятичный без знака
x = Шестнадцатеричный

Общий форма записи спецификатора формата следующая:

%[Index:][-][Width][.Precision]Type

В квадратных скобках указаны необязательные параметры, определяющие особенности форматирования данных: [Index] — индекс аргумента, [-] — признак выравнивания по левому краю; [Width] — ширина вывода; [.Precision] — точность вывода.

Если строка имеет недопустимый формат, передаётся недостаточное количество аргументов или какие-либо аргументы имеют неправильный тип, будет вызвано исключение.

Пример

var
  S: String;
  I: Integer;
begin
  S := Format('Найдено файлов: %d', [10]);
  // S = 'Найдено файлов: 10'

  S := Format('Файл: %s', ['file.txt']);
  // S = 'Файл: file.txt'

  I := 64;
  S := Format('%d в формате НЕХ (дополнено до 8 разрядов): %.8x', [I, I]);
  // S = '64 в формате НЕХ (дополнено до 8 разрядов): 00000040'
end;