|
Функция Format возвращает форматированную строку.
function Format(const Format: string; const Args: array of const): string;
где:
Format – форматирующая строка – обычная текстовая строка,
но в ней на нужных местах стоят специальные символы, которые определяют, какие и как
туда будут подставлены параметры;
Args – список аргументов – содержит "вставляемые" в
форматирующую строку параметры; этот открытый массив имеет тип array of
const, и в нем может передаваться переменное число
разнотипных параметров.
"Специальные" места в форматирующей строке называются спецификаторами формата и
представляют собой следующий синтаксис:
"%" [index ":"] ["-"] [width] ["." prec] type
где обозначены:
"%" – символ, с которого начинаются все спецификаторы формата
(обязательный);
[index ":"] – поле индекса аргумента (необязательное);
["-"] – признак выравнивания по левому краю
(необязательный);
[width] – поле ширины (необязательное);
["." prec] – поле точности (необязательное);
type – символ типа преобразования (обязательный).
Рассмотрим следующие символы типа преобразования type:
где:
d (десятичный) – элемент должен быть целым числом (со знаком) и
преобразуется в строку десятичных цифр; если строка формата содержит спецификатор
точности ["." prec], он указывает, что результирующая строка должна
содержать как минимум указанное количество цифр prec; если в значении
меньше цифр, результирующая строка дополняется нулями слева,
например,
Format('%d', [-7]) выведет
'-7';
Format('%.5d', [-7]) или
Format('%.*d', [5, -7]) выведет
'-00007' (содержит знак "минус" {он не включается в поле точности
["." prec]} и 5 цифр);
Format('%5d', [-7]),
Format('%5.d', [-7]),
Format('%*d', [5, -7]) или
Format('%*.d', [5, -7]) выведет
' -7' (содержит 3 пробела,
знак "минус" и цифру /всего 5 символов/);
Format('%-6.d', [-3]) или
Format('%-*.d', [6, -3]) выведет
'-3 ' (содержит знак
"минус", цифру и 4 пробела /всего 6 символов/);
Format('%10.5d', [-32]) или
Format('%*.*d', [10, 5, -32]) выведет
' -00032' (содержит 4
пробела, знак "минус" и 5 цифр /всего
10 символов/);
Format('%-10.5d', [-12]) или
Format('%-*.*d', [10, 5, -12]) выведет
'-00012 ' (содержит
знак "минус", 5 цифр и 4 пробела /всего
10 символов/);
Format('%5:d', [6, 3, 8, 1, 4, -6, 3]) выведет
'-6' (5-й индекс
агрумента – это элемент '-6'
{индексация в массиве начинается с
нуля});
Format('%4:d %1:d %d %d %d %0:d %d', [-3, 7, 10, -5, -12, 1])
выведет '-12 7 10 -5 -12 -3 7' (по очереди
обработает индексы агрумента в следующем порядке: 4,
1, 2,
3, 4,
0, 1 /если индекс не
указан, то функция обработает следующий элемент/);
Format('%2:-*.*d', [6, 8, 10, 4, -12]) выведет
'-0012 ' (индекс
в массиве начинается со 2-й позиции, значит,
функция обработает такой список аргументов: 10, 4, -12; результат
содержит знак "минус", 4 цифры и 5 пробелов /всего
10 символов/);
u (беззнаковый десятичный) – элемент должен быть целым числом
(без знака) и преобразуется в строку десятичных цифр (аналогично типу
d, но знак "минус" не выводится),
например,
Format('%u', [7]) выведет
'7';
Format('%u', [-7]) выведет
'4294967289' (4 миллиарда образовались
следующим образом: модуль числа -7 представить
прямым кодом в 16 двоичных разрядах (перевод числа
7 из десятичной формы записи числа в двоичное),
далее значения всех разрядов инвертировать (все нули заменить единицами, а
единицы – нулями), потом к полученному представлению, рассматриваемому
как 16-разрядное неотрицательное двоичное число, прибавить единицу, и,
наконец, полученное двоичное число перевести в десятичное, т.е. схема выглядит
следующим образом: 710 → 1112 →
0000 0000 0000 0000 0000 0000 0000 01112
{16 бит} →
1111 1111 1111 1111 1111 1111 1111 10002
{инвертирование} →
1111 1111 1111 1111 1111 1111 1111 10012
{добавление единицы} → 429496728910);
e (научный) – элемент должен быть числом с плавающей точкой
(вещественное число) и преобразуется в строку нормализованного вида
"-d.dddE+ddd" (экспоненциальная нотация) –
результирующая строка начинается с знака минус, если число отрицательное, и перед
десятичной точкой всегда находится одна цифра, после символа
"E" (экспонента) идет показатель степени, имеющий
знак и состоящий не менее чем из 3 цифр; общее число цифр в представлении числа
(включая цифру перед десятичной точкой) задается спецификатором точности в строке
формата ["." prec] (если спецификатор точности отсутствует, по
умолчанию принимается точность 15); значение Args должно быть числом с
плавающей точкой или Currency,
например,
Format('%e', [-7.]) выведет
'-7,00000000000000E+000' (обратите внимание на
то, что в списке аргументов Args не допускается использовать
целые числа, поскольку это приведет к аварийной ошибке; целые числа необходимо
указывать хотя бы как вещественные, например,
'3.' или
'3.0');
Format('%e', [123.456]) выведет
'1,23456000000000E+002';
Format('%e', [-0.000987]) выведет
'-9,87000000000000E-004';
Format('%e', [1234567890.123456789]) выведет
'1,23456789012346E+009';
Format('%.5e', [-765.4321]) или
Format('%.*e', [5, -765.4321]) выведет
'-7,6543E+002' (до символа
"E" число содержит
5 цифр, однако, знаки "минус" и "запятая" не
включаются в поле точности ["." prec]);
Format('%.0e', [-765.4321]) или
Format('%.*e', [0, -765.4321]) выведет
'-7,7E+002' (если поле точности
["." prec] меньше или равно 2, то
функция вернет минимум 2 цифры);
Format('%17.e', [-765.4321]) или
Format('%*.e', [17, -765.4321]) выведет
' -7,7E+002'
(содержит 8 пробелов, знаки "минус" и "запятая", 2 цифры, символы "E" и "+" и
3 цифры /всего 17 символов – это и есть длина
строки/);
Format('%-17.e', [-765.4321]) или
Format('%-*.e', [17, -765.4321]) выведет
'-7,7E+002 '
(то же самое, что и в предыдущем примере, только 8 пробелов находятся справа
/после результата/);
Format('%17.5e', [-765.4321]) или
Format('%*.*e', [17, 5, -765.4321]) выведет
' -7,6543E+002'
(длина строки состоит из 17 символов, из них
5 цифр отводится на само число до символа
"E");
Format('%3:-20.10e', [-765.4321, 5, -12, 1989.03]) или
Format('%3:-*.*e', [-765.4321, 5, -12, 20, 10, 1989.03])
выведет
'1,989030000E+003 '
(индекс в массиве начинается с 3-й позиции, значит,
функция не будет учитывать следующие аргументы: -765.4321, 5,
-12);
f (фиксированный) – элемент должен быть числом с плавающей
точкой (вещественное число) и преобразуется в строку вида
"ddd.ddd" (фиксированная нотация); результирующая
строка начинается с знака минус, если число отрицательное; поле точности в строке
формата ["." prec] определяет количество цифр после десятичного
разделителя (если спецификатор точности отсутствует, по умолчанию принимается 2
цифры после точки); значение Args должно быть числом с плавающей точкой
или Currency, например,
Format('%f', [-3.]) выведет
'-3,00' (обратите внимание на
то, что в списке аргументов Args не допускается использовать
целые числа, поскольку это приведет к аварийной ошибке; целые числа необходимо
указывать хотя бы как вещественные, например,
'5.' или
'5.0');
Format('%f', [147852.369]) выведет
'147852,37';
Format('%f', [-0.000987]) выведет
'0,00';
Format('%.5f', [-12.3456789]) или
Format('%.*f', [5, -12.3456789]) выведет
'-12,34568' (после десятичного разделителя
число содержит 5 цифр);
Format('%.0f', [-987.654]) или
Format('%.*f', [0, -987.654]) выведет
'-988' (функция работает по правилу
округления);
Format('%10.f', [-125.125]) или
Format('%*.f', [10, -125.125]) выведет
' -125'
(длина строки состоит из 10 символов: 6 пробелов,
знак "минус" и 3 цифры);
Format('%10f', [-125.125]) или
Format('%*f', [10, -125.125]) выведет
' -125,13'
(длина строки состоит из 10 символов: 3 пробела,
знак "минус", 3 цифры, "запятая" и еще 2 цифры по умолчанию);
Format('%-10.f', [-125.125]) или
Format('%-*.f', [10, -125.125]) выведет
'-125 '
(то же самое, что и в предыдущем примере, только 6 пробелов находятся справа
/после результата/);
Format('%-10f', [-125.125]) или
Format('%-*f', [10, -125.125]) выведет
'-125,13 ';
Format('%20.7f', [-9891.29198905]) или
Format('%*.*f', [20, 7, -9891.29198905]) выведет
' -9891,2919891'
(длина строки состоит из 20 символов, из них
7 цифр отводится на количество цифр после запятой
– десятичного разделителя);
Format('%2:-8.1f', [-7, 5, 1.175]) или
Format('%2:-*.*f', [-7, 5, 8, 1, 1.175]) выведет
'1,2 '
(индекс в массиве начинается со 2-й позиции);
g (обобщенный) – элемент должен быть числом с плавающей точкой и
преобразуется к одному из двух вышеперечисленных видов (e или
f) – выбирается тот, который обеспечивает более короткую запись;
количество значащих цифр в результирующей строке задается спецификатором точности в
строке формата ["." prec] (если спецификатор точности отсутствует, по
умолчанию принимается точность 15); конечные нули удаляются из результирующей
строки, а десятичная точка появляется только при необходимости; если количество цифр
слева от десятичной точки в значении меньше или равно указанной точности, и если
значение больше или равно 0.0001, применяется
фиксированный тип (f), в противном случае результирующая строка
использует научный формат (e),
например,
Format('%g', [-2.]) выведет
'-2';
Format('%g', [-0.0001]) выведет
'-0,0001';
Format('%g', [-0.00001]) выведет
'-1E-5';
Format('%.1g', [-0.000123456789]) или
Format('%.2g', [-0.000123456789]) выведет
'-0,00012' (содержит как минимум
2 значащиеся цифры);
Format('%.3g', [-0.000123456789]) выведет
'-0,000123';
Format('%.7g', [-0.000123456789]) выведет
'-0,0001234568';
Format('%.1g', [-0.0000123456789]) или
Format('%.2g', [-0.0000123456789]) выведет
'-1,2E-5';
Format('%.3g', [-0.0000123456789]) выведет
'-1,23E-5';
Format('%.7g', [-0.0000123456789]) выведет
'-1,234568E-5';
Format('%.1g', [-15.123456789]) или
Format('%.2g', [-15.123456789]) выведет
'-15';
Format('%.3g', [-15.123456789]) выведет
'-15,1';
Format('%.7g', [-15.123456789]) выведет
'-15,12346';
Format('%.6g', [123456.789]) выведет
'123457' (содержит
6 цифр);
Format('%.7g', [123456.789]) выведет
'123456,8' (содержит
7 цифр /"запятая" не учитывается/);
n (числовой) – элемент должен быть числом с плавающей
точкой (вещественное число) и совпадает с типом f за исключением того,
что после каждой группы из трех цифр ставятся разделительные символы (разделители
тысяч), значение которого преобразуется в строку вида
"-d,ddd,ddd.ddd..."; способ представления строки
зависит от значения глобальной константы ThousandSeparator,
определенной в модуле SysUtils и зависящий от настройки Windows,
например,
Format('%n', [-7.]) выведет
'-7,00';
Format('%n', [-7.125]) выведет
'-7,13';
Format('%n', [-999.99]) выведет
'-999,99';
Format('%n', [-999.999]) выведет
'-1 000,00';
Format('%n', [1234567890.12345]) выведет
'1 234 567 890,12';
Format('%.5n', [0.0000123]) выведет
'0,00001' (содержит
5 цифр после запятой);
Format('%.5n', [10000000.123]) выведет
'10 000 000,12300';
Format('%.0n', [10000000.543]) выведет
'10 000 001';
m (денежный) – элемент должен быть числом с плавающей
точкой (вещественное число) и совпадает с типом f, представляющий
денежную сумму, способ представления которого зависит от значений глобальных
переменных CurrencyString, CurrencyFormat,
NegCurrFormat, ThousandSeparator,
DecimalSeparator и CurrencyDecimals, определенных в модуле
SysUtils, все из которых инициализируются из настроек локали и зависят
от настройки Windows (очень похож на тип n),
например,
Format('%m', [-7.]) выведет
'-7,00 ₽' (обратите внимание на то,
что символ '₽' в старых версиях Delphi
может не отображаться, вместо него функция выводит знак вопроса, например,
'-7,00 ?');
Format('%m', [-7.125]) выведет
'-7,13 ₽';
Format('%m', [1234567890.12345]) выведет
'1 234 567 890,12 ₽';
Format('%.5m', [0.0000123]) выведет
'0,00001 ₽' (содержит
5 цифр после запятой);
Format('%.0m', [1000000.5]) выведет
'1 000 001 ₽';
p (указатель) – элемент должен быть указателем, на выходе он
будет представлять из себя строку шестнадцатиричных цифр вида
"XXXX:YYYY", где
XXXX – сегментная часть указателя,
YYYY – смещенная часть указателя, выраженные
каждая из них по четырьмя шестнадцатеричными цифрами; значение Args
должно быть указателем, например,
Format('%p', [@i]) или
Format('%p', [Addr(i)]) выведет
'0019EFDC' (обратите внимание на то,
что переменная i может быть любого типа, также допускаются
указывать и объекты, например, @Label1);
Format('%12.p', [@i]) или
Format('%12p', [@i]) выведет
' 0019EFDC' (содержит 4
пробела и 8 цифр, итого 12 символов);
s (строка) – элемент может иметь строковый тип
(String, AnsiString, WideStririg,
PChar, PWideChar и другие) или быть отдельным символом
(Char, AnsiChar); если в строке формата присутствует поле
["." prec] и длина строки больше его значения, то она усекается, т.е.
prec задает максимальную длину результирующей строки,
например,
Format('%s', ['Привет! Как дела?']) выведет
'Привет! Как дела?';
Format('%.7s', ['Привет! Как дела?']) выведет
'Привет!' (содержит
7 символов);
Format('%20s', ['Привет! Как дела?']) выведет
' Привет! Как дела?'
(содержит 3 пробела, 6 букв, восклицательный знак, пробел, 3 буквы, пробел, 4
буквы, вопросительный знак, итого 20 символов);
Format('%-20s', ['Привет! Как дела?']) выведет
'Привет! Как дела? ' (то же
самое, что и в предыдущем примере, только 3 пробела находятся справа /после
результата/);
x (шестнадцатеричный) – элемент должен быть целым числом (знак
числа не имеет значения) и преобразуется в строку шестнадцатиричных цифр (аналогично
типу u); поле точности ["." prec] указывает, что
результирующая строка должна содержать минимальное число выводимых цифр; если в
значении меньше цифр, результирующая строка дополняется нулями слева,
например,
Format('%x', [1000]) выведет
'3E8';
Format('%x', [-5]) выведет
'FFFFFFFB';
Format('%.5x', [1023]) выведет
'003FF' (содержит 5
цифр);
Format('%5.x', [1023]) или
Format('%5x', [1023]) выведет
' 3FF' (содержит 2 пробела и 3
цифры, всего 5 символов);
% (процент) – элемент является процентом,
например,
Format('%%', []) выведет
'%';
Format('%d%%', [75]) выведет
'75%'.
Примечание. При выводе вещественных (дробных) чисел
вместо "запятой", может выводится "точка" в зависимости от настроек Вашей операционной
системы, например, '1,5'
или '1.5'.
|