Delphi 中 Format 函数的用法详解

Delphi 中 Format 函数的用法详解

Format 是 Delphi 中用于格式化字符串的常用函数，功能类似于 C 语言的 printf 或 C# 的 String.Format。
基本语法

1. function Format(const FormatStr: string; const Args: array of const): string;

复制代码

参数说明

• FormatStr：格式字符串，包含普通文本和格式说明符
  
• Args：可变参数数组，提供要格式化的值
  

格式说明符语法

格式说明符基本形式：%[index:][-][width][.precision]type
常用格式类型

类型说明示例d十进制整数Format('%d', [10]) → '10'x十六进制小写Format('%x', [255]) → 'ff'X十六进制大写Format('%X', [255]) → 'FF'e科学计数法Format('%e', [1234.567]) → '1.234567E+03'f浮点数Format('%f', [1234.567]) → '1234.567'g通用格式Format('%g', [1234.567]) → '1234.567'n千位分隔Format('%n', [1234.567]) → '1,234.567'm货币格式Format('%m', [1234.567]) → '¥1,234.57' (取决于区域设置)p指针地址Format('%p', [@MyVar]) → '0012FEC0's字符串Format('%s', ['Delphi']) → 'Delphi'使用示例

基本示例

1. var
2.   s: string;
3. begin
4.   s := Format('姓名：%s，年龄：%d岁', ['张三', 25]);
5.   // 结果：'姓名：张三，年龄：25岁'
6. end;

复制代码

指定参数索引

1. s := Format('%0:d %1:d %0:d', [10, 20]);
2. // 结果：'10 20 10'

复制代码

控制宽度和对齐

1. s := Format('%-10s%10d', ['测试', 123]);
2. // 结果：'测试        123'（左对齐和右对齐）

复制代码

浮点数格式化

1. s := Format('%.2f', [3.14159]);
2. // 结果：'3.14'（保留2位小数）
4. s := Format('%8.2f', [3.14159]);
5. // 结果：'    3.14'（总宽度8，右对齐）

复制代码

日期时间格式化

1. s := Format('日期：%s，时间：%s',
2.   [DateToStr(Now), TimeToStr(Now)]);

复制代码

多参数复杂格式

1. s := Format('产品：%s，单价：%m，库存：%d件，占比：%.1f%%',
2.   ['手机', 3999.99, 150, 75.5]);
3. // 结果：'产品：手机，单价：¥3,999.99，库存：150件，占比：75.5%'

复制代码

注意事项

• 单元引用：Format 函数位于 System.SysUtils 单元
  
• 参数匹配：格式说明符数量必须与参数数量匹配
  
• 性能考虑：频繁调用时，考虑使用 TStringBuilder
  
• 本地化：某些格式（如货币、日期）受系统区域设置影响
  
• 错误处理：不匹配的格式可能导致异常
  

高级用法

自定义日期格式

1. s := FormatDateTime('yyyy-mm-dd hh:nn:ss', Now);

复制代码

格式化数组

1. var
2.   arr: array[0..2] of Integer;
3. begin
4.   arr[0] := 10;
5.   arr[1] := 20;
6.   arr[2] := 30;
7.   s := Format('数组：%d,%d,%d', [arr[0], arr[1], arr[2]]);
8. end;

复制代码

Format 是 Delphi 字符串处理中最强大和灵活的函数之一，掌握它可以极大地简化复杂的字符串构建任务。
Delphi 格式说明符详解

格式说明符的基本形式为：%[index:][-][width][.precision]type。下面我将详细解释每个部分的含义：
1. % - 起始符号

• 每个格式说明符都必须以百分号 % 开头
  

2. [index:] - 参数索引（可选）

• 用于指定使用哪个参数（从0开始）
  
• 格式：数字后跟冒号（如 0:、1:）
  
• 示例：
  1. Format('%1:s %0:s', ['World', 'Hello'])  // 结果为 "Hello World"

  复制代码

3. [-] - 对齐方式（可选）

• - 表示左对齐，默认是右对齐
  
• 示例：
  1. Format('%-10s', ['Hi'])  // "Hi        " (左对齐，总宽度10)
  2. Format('%10s', ['Hi'])   // "        Hi" (右对齐，总宽度10)

  复制代码

4. [width] - 最小宽度（可选）

• 指定输出内容的最小宽度（字符数）
  
• 如果实际内容比宽度短，会用空格填充
  
• 示例：
  1. Format('%5d', [42])  // "   42" (总宽度5)

  复制代码

5. [.precision] - 精度（可选）

• 对于浮点数：指定小数位数
  
• 对于字符串：指定最大字符数
  
• 格式：小数点后跟数字
  
• 示例：
  1. Format('%.2f', [3.14159])  // "3.14" (保留2位小数)
  2. Format('%.5s', ['Delphi'])  // "Delph" (最多5个字符)

  复制代码

6. type - 格式类型（必需）

• 指定如何格式化参数，必须的最后一个字符
  
• 常用类型：
  
  
  
  • d：十进制整数
    
  • x/X：十六进制（小写/大写）
    
  • e/E：科学计数法
    
  • f：固定小数位数
    
  • g/G：通用格式（自动选择最短表示）
    
  • n：带千位分隔符的数字
    
  • m：货币格式
    
  • p：指针地址
    
  • s：字符串
    
  
  

综合示例

1. var
2.   s: string;
3. begin
4.   // 参数索引:1，左对齐，总宽度15，保留3位小数
5.   s := Format('%1:-15.3f', [3.14159, 123.456789]);
6.   // 结果："123.457      " (使用第二个参数，左对齐，宽度15)
7.   
8.   // 参数索引:0，右对齐，总宽度10，十六进制大写
9.   s := Format('%0:10X', [255]);
10.   // 结果："        FF" (右对齐，宽度10)
11.   
12.   // 字符串，最大长度4
13.   s := Format('%.4s', ['Programming']);
14.   // 结果："Prog"
15. end;

复制代码

注意事项

• 方括号 [] 表示该部分是可选的，实际使用时不需要写这些括号
  
• 参数索引从0开始
  
• 宽度和精度都可以用*代替，此时从参数中获取值：
  1. Format('%*.*f', [8, 2, 3.14159])  // "    3.14" (宽度8，精度2)

  复制代码
• 要显示百分号本身，需要使用 %%
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！