Format, функция

Синтаксис


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

Описание

Функция Format возвращает форматированную строку. Аргумент Format указывает, как формировать строку, используя аргументы из вариантного открытого массива Args. Строка Format копируется в результирующую строку, при этом разворачиваются спецификаторы формата, обозначенные знаком процента (%). Для того чтобы определить знак процента как литерал, повторите его: %%. Все спецификаторы формата имеют следующий синтаксис:
% [index :] [ - ] [~width] [.precision] type
index -это индекс в массиве Args, где первый аргумент обозначается нулем. Без указания индекса каждый спецификатор формата соответствует следующему элементу массива Args. Если указан индекс, можно несколько раз повторять один и тот же аргумент в одной строке формата. Планируя локализовать приложение, следует использовать спецификатор индекса для всех аргументов, т. к. в другом языке может потребоваться другой порядок аргументов.
width определяет минимальное количество символов для форматируемого поля. Если фактическая форматируемая величина меньше, чем width символов, она дополняется пробелами слева. Если перед width указан знак "минус", число выравнивается слева и дополняется пробелами справа.
Разные типы форматов по-разному используют precision. Подробности рассмотрены в описаниях каждого из форматов.
Можно жестко указать числовые значения index, width и precision в строке формата (например %1:10.2f) или использовать звездочку для любого или всех этих значений (например %*:*. * f). Тогда для данного значения будет использован следующий аргумент из массива Args. Значение Args должно быть целым.
Тип формата (type) обозначается одним символом в верхнем или нижнем регистре:
d
Форматирует десятичное целое со знаком. Precision определяет минимальное число выводимых цифр; по необходимости число дополняется нулями. Значение Args должно быть целым.
е Форматирует вещественное число в соответствии с экспоненциальной нотацией. Precision определяет общее число цифр в форматированной строке. По умолчанию равно 15. Значение Args должно быть числом с плавающей точкой или Currency.
f
Форматирует вещественное число в соответствии с фиксированной нотацией. Precision определяет количество цифр после десятичного разделителя. По умолчанию равно 2. Значение Args должно быть числом с плавающей точкой или Currency.
g
Форматирует вещественное число в соответствии с общей нотацией. Precision определяет количество значащих цифр. Значение Args должно быть числом с плавающей точкой или Currency.
m
Форматирует значение типа Currency. Precision определяет количество знаков после десятичной точки. Значение по умолчанию определяется переменной CurrencyDecimals, а формат валюты-переменными CurrencyFornat и NegCurrFormat. Значение Args должно быть числом с плавающей точкой или Currency.
n
Форматирует вещественное число в соответствии с числовой нотацией, т. е. по правилам фиксированной нотации с разделителем ThousandSeparator для групп из трех цифр. Значение Args должно быть числом с плавающей точкой или Currency.
р
Форматирует указатель как шестнадцатеричное число. Значение Args должно быть указателем.
s
Форматирует символ или строку. Precision определяет максимальное число выводимых символов. Значение Args должно иметь тип AnsiChar, AnsiString, PChar, PWideChar, ShortString, Variant или WideStririg. Тип WideChar не допускается. Variant преобразуется в строку и затем форматируется.
u
Форматирует целое десятичное число без знака. Precision определяет минимальное число выводимых десятичных цифр; число дополняется по необходимости нулями. Значение Args должно быть целым.
х
Форматирует шестнадцатеричное целое без знака. Регистр спецификатора типа определяет регистр символов шестнадцате-ричного числа. Precision определяет минимальное число выводимых цифр, при необходимости дополняется нулями. Значение Args должно быть целым.
Если строка формата содержит ошибки или если type не совпадает с типом соответствующего аргумента массива Args, Format генерирует исключительную ситуацию EConvertError.

Ошибки

Советы и приемы

Пример



Смотрите также

    Учебник по языку Pascal          Лабораторные работы по программированию          Справочник




Нет комментариев.



Оставить комментарий:
Ваше Имя:
Email:
Антибот: *  
Ваш комментарий: