format

Синтаксис:

format(type, par1, par2);

Аргументы:

Имя	Тип данных	Описание
type	`integer`	Формат формируемой строки
par1	`integer`	Первый параметр формата формируемой строки
par2	`integer`	Второй параметр формата формируемой строки

Описание:

format(type, par1, par2) – установка формата формирования строки из переменной типа «число с плавающей запятой». Формат используется в функции datatostr и при отображении переменных в окне просмотра переменных. Если количество цифр в формируемой строке меньше количества цифр исходного числа, число округляется. Переменная type определяет формат вывода:

Формат автоматический (general). type = 0. Число преобразовывается в наиболее возможно короткую десятичную строку, используя фиксированный (fixed) или научный формат (scientific). Нули в конце числа удаляются. Десятичная точка ставится только в случае необходимости. Фиксированный формат применяется, когда в значении числа количество цифр, стоящих слева от десятичной точки, меньше либо равно par1 или, когда значение числа >= 0.00001. В противном случае, применяется научный формат, а параметр par2 определяет минимальное число цифр в экспоненте (0.. 4).
Формат научный (scientific). type = 1. par1 – количество значащих цифр мантиссы, минимальное значение – 2 цифры; par2 – количество значащих цифр экспоненты, минимальное значение – 1 цифра. Число преобразуется в строку формата "-x.xxx…E+xxxx". Строка начинается со знака "-" (если число отрицательное). Десятичной точке всегда предшествует одна цифра. Параметр par1 определяет общее количество десятичных цифр, стоящих до символа экспоненты "E" (включая цифру слева от десятичного разделителя). За символом экспоненты следует знак плюс или минус и до 4 цифр, определяющих степень экспоненты. Минимальное число цифр в экспоненте указывается в параметре par1.
Формат фиксированный (fixed). type = 2. par1 – общее количество значащих цифр, минимальное значение – 2 цифры; par2 – количество цифр после запятой. Значение преобразуется в строку вида "-ххх.ххх…". Если число отрицательное, то впереди строки будет поставлен знак "-". Десятичной точке всегда предшествует минимум одна цифра. Количество значащих цифр после десятичной точки (0…18) указывается в параметре par2. Если количество разрядов слева от разделителя превышает значение, указанное в параметре par1, то для форматирования будет использоваться научный формат (ffExponent).

Результат:

Имя	Тип данных	Описание
		Функция устанавливает формат

Пример:

var
x1: double = 3.14159,
x2: double = 31.4159,
x3: double = 314.159;
//сформируем строку из переменной в формате general
format(0, 4, 0);                                   
s1 = datatostr(x1); // «3.142»
//сформируем строку из переменной в формате scientific
format(1, 3, 2);                                      
s2 = datatostr(x3); // «3.14E+02»                     
//сформируем строку из переменной в формате fixed     
format(2, 4, 3);                                      
s3 = datatostr(x3); // «314.200»                      
format(2, 6, 3);                                      
s4 = datatostr(x3); // «314.159»                      
format(2, 1, 3);                                      
s5 = datatostr(x3); // « 3.1E002»

В результате переменная s1 будет содержать строку «3.142» - выводятся 4 значащих цифры, число округляется; переменная s2 будет содержать строку «3.14E+02» - выводятся 3 цифры мантиссы и 2 цифры экспоненты в экспоненциальной форме записи, переменная s3 будет содержать строку «314.200», переменная s4 будет содержать строку «314.159», переменная s5 будет содержать строку «3.1E002».

Дополнительные материалы

Нет.