fbpx
维基百科

格式化字符串

二月 17, 2023

格式化字符串（英語：format string）是一些程序设计语言的输入/输出库中能將字符串参数轉換為另一種形式輸出的函数。例如C、C++等程序设计语言的printf类函数，其中的转换说明（conversion specification）用于把随后对应的0个或多个函数参数转换为相应的格式输出；格式化字符串中转换说明以外的其它字符原样输出。[1]

一个printf函数的例子

C语言printf函数为代表的一类

格式化占位符

格式化字符串中的占位符用于指明输出的参数值如何格式化。

格式化占位符（format placeholder），语法是：

%[parameter][flags][field width][.precision][length]type

Parameter可以忽略或者是：

字符 描述
n$ n是用这个格式说明符（specifier）显示第几个参数；这使得参数可以输出多次，使用多个格式说明符，以不同的顺序输出。 如果任意一个占位符使用了parameter，则其他所有占位符必须也使用parameter。这是POSIX扩展，不属于ISO C。例：printf("%2$d %2$#x; %1$d %1$#x",16,17) 产生"17 0x11; 16 0x10"

Flags可为0个或多个：

字符 描述
+ 总是表示有符号数值的'+'或'-'号，缺省情况是忽略正数的符号。仅适用于数值类型。
空格 使得有符号数的输出如果没有正负号或者输出0个字符，则前缀1个空格。如果空格与'+'同时出现，则空格说明符被忽略。
- 左对齐。缺省情况是右对齐。
# 对于'g'与'G'，不删除尾部0以表示精度。对于'f', 'F', 'e', 'E', 'g', 'G', 总是输出小数点。对于'o', 'x', 'X', 在非0数值前分别输出前缀0, 0x, and 0X表示数制。
0 如果width选项前缀以0，则在左侧用0填充直至达到宽度要求。例如printf("%2d", 3)输出" 3"，而printf("%02d", 3)输出"03"。如果0与-均出现，则0被忽略，即左对齐依然用空格填充。

Field Width给出显示数值的最小宽度，典型用于制表输出时填充固定宽度的表目。实际输出字符的个数不足域宽，则根据左对齐或右对齐进行填充。实际输出字符的个数超过域宽并不引起数值截断，而是显示全部。宽度值的前导0被解释为0填充标志，如上述；前导的负值被解释为其绝对值，负号解释为左对齐标志。如果域宽值为*，则由对应的函数参数的值为当前域宽。

Precision通常指明输出的最大长度，依赖于特定的格式化类型。对于d、i、u、x、o的整型数值，是指最小数字位数，不足的位要在左侧补0，如果超过也不截断，缺省值为1。对于a,A,e,E,f,F的浮点数值，是指小数点右边显示的数字位数，必要时四舍五入或补0；缺省值为6。对于g,G的浮点数值，是指有效数字的最大位数；缺省值为6。对于s的字符串类型，是指输出的字节的上限，超出限制的其它字符将被截断。如果域宽为*，则由对应的函数参数的值为当前域宽。如果仅给出了小数点，则域宽为0。

Length指出浮点型参数或整型参数的长度。此项Microsoft称为“Size”。可以忽略，或者是下述：

字符 描述
hh 对于整数类型，printf期待一个从char提升的int尺寸的整型参数。
h 对于整数类型，printf期待一个从short提升的int尺寸的整型参数。
l 对于整数类型，printf期待一个long尺寸的整型参数。

对于浮点类型，printf期待一个double尺寸的整型参数。对于字符串s类型，printf期待一个wchar_t指针参数。对于字符c类型，printf期待一个wint_t型的参数。

ll 对于整数类型，printf期待一个long long尺寸的整型参数。Microsoft也可以使用I64。
L 对于浮点类型，printf期待一个long double尺寸的整型参数。
z 对于整数类型，printf期待一个size_t尺寸的整型参数。
j 对于整数类型，printf期待一个intmax_t尺寸的整型参数。
t 对于整数类型，printf期待一个ptrdiff_t尺寸的整型参数。

此外，在ISO C99广泛接受前，还有几个平台相关的length选项：

字符 描述
I 对于有符号整数类型，printf期待一个ptrdiff_t尺寸的整型参数。对于无符号整数类型，printf期待一个size_t尺寸的整型参数。常见于Win32/Win64平台。
I32 对于整数类型，printf期待一个32位（双字）的整型参数。常见于Win32/Win64平台。
I64 对于整数类型，printf期待一个64位（四字）的整型参数。常见于Win32/Win64平台。
q 对于整数类型，printf期待一个64位（四字）的整型参数。常见于BSD平台。

ISO C99的头文件inttypes.h包含了许多宏，用于平台独立的printf编码。例如：

宏 定义
PRId32 典型地等效于I32d (Win32/Win64)或d
PRId64 典型地等效于I64d (Win32/Win64), lld (32位平台)或ld (64位平台)
PRIi32 典型地等效于I32i (Win32/Win64)或i
PRIi64 典型地等效于I64i (Win32/Win64), lli (32位平台)或li (64位平台)
PRIu32 典型地等效于I32u (Win32/Win64)或u
PRIu64 典型地等效于I64u (Win32/Win64), llu (32位平台)或lu (64位平台)
PRIx32 典型地等效于I32x (Win32/Win64)或x
PRIx64 典型地等效于I64x (Win32/Win64), llx (32位平台)或lx (64位平台)

类型

Type，也称转换说明（conversion specification/specifier），可以是：

字符 描述
d, i 有符号十进制数值int。'%d'与'%i'对于输出是同义；但对于scanf()输入二者不同，其中%i在输入值有前缀0x或0时，分别表示16进制或8进制的值。如果指定了精度，则输出的数字不足时在左侧补0。默认精度为1。精度为0且值为0，则输出为空。
u 十进制unsigned int。如果指定了精度，则输出的数字不足时在左侧补0。默认精度为1。精度为0且值为0，则输出为空。
f, F double型输出10进制定点（英语：Fixed-point arithmetic）表示。'f'与'F'差异是表示无穷与NaN时，'f'输出'inf', 'infinity'与'nan'；'F'输出'INF', 'INFINITY'与'NAN'。小数点后的数字位数等于精度，最后一位数字四舍五入。精度默认为6。如果精度为0且没有#标记，则不出现小数点。小数点左侧至少一位数字。
e, E double值，输出形式为10进制的([-]d.ddd e[+/-]ddd). E版本使用的指数符号为E（而不是e）。指数部分至少包含2位数字，如果值为0，则指数部分为00。Windows系统，指数部分至少为3位数字，例如1.5e002，也可用Microsoft版的运行时函数_set_output_format 修改。小数点前存在1位数字。小数点后的数字位数等于精度。精度默认为6。如果精度为0且没有#标记，则不出现小数点。
g, G double型数值，精度定义为全部有效数字位数。当指数部分在闭区间 [-4,5] 内，输出为定点形式；否则输出为指数浮点形式。'g'使用小写字母，'G'使用大写字母。小数点右侧的尾数0不被显示；显示小数点仅当输出的小数部分不为0。
x, X 16进制unsigned int。'x'使用小写字母；'X'使用大写字母。如果指定了精度，则输出的数字不足时在左侧补0。默认精度为1。精度为0且值为0，则输出为空。
o 8进制unsigned int。如果指定了精度，则输出的数字不足时在左侧补0。默认精度为1。精度为0且值为0，则输出为空。
s 如果没有用l标志，输出null结尾字符串（英语：null-terminated string）直到精度规定的上限；如果没有指定精度，则输出所有字节。如果用了l标志，则对应函数参数指向wchar_t型的数组，输出时把每个宽字符转化为多字节字符，相当于调用wcrtomb函数。
c 如果没有用l标志，把int参数转为unsigned char型输出；如果用了l标志，把wint_t参数转为包含两个元素的wchart_t数组，其中第一个元素包含要输出的字符，第二个元素为null宽字符。
p void *型
a, A double型的16进制表示，"[−]0xh.hhhh p±d"。其中指数部分为10进制表示的形式。例如：1025.010输出为0x1.004000p+10。'a'使用小写字母，'A'使用大写字母。[2][3] （C++11流使用hexfloat输出16进制浮点数）
n 不输出字符，但是把已经成功输出的字符个数写入对应的整型指针参数所指的变量。
% '%'字面值，不接受任何flags, width, precision or length。

宽度与精度格式化参数可以忽略，或者直接指定，或者用星号"*"表示取对应函数参数的值。例如printf("%*d", 5, 10)输出"   10"；printf("%.*s", 3, "abcdef") 输出"abc"。

如果函数参数太少，不能匹配所有的格式参数说明符，或者函数参数的类型不匹配，将导致未定义（undefined）行为。过多的函数参数被忽略。许多时候，未定义的行为将导致格式化字符串攻击（英语：Format string attack）。

某些编译器，如GCC，会静态检查printf这一类函数的格式化参数并编译警告存在的问题（当使用编译标志-Wall或-Wformat）。GCC也会对用户自定义的printf风格函数做静态检查，如果在函数定义时使用了非标准的 __attribute__((format(...)))。

具有printf风格函数的编程语言

此外，Windows API的FormatMessage函数也使用格式化字符串说明。

参考文献

  1. ^ C11 standard n1570 draft. 7.21.6.1.3 pp309
  2. ^ "The GNU C Library Reference Manual", "12.12.3 Table of Output Conversions". Gnu.org. [2014-03-17]. （原始内容于2021-03-27）. 
  3. ^ "printf" （页面存档备份，存于互联网档案馆） ("%a" added in C99)

外部链接

二月 17, 2023
格式化字符串, 英語, format, string, 是一些程序设计语言的输入, 输出库中能將字符串参数轉換為另一種形式輸出的函数, 例如c, 等程序设计语言的printf类函数, 其中的转换说明, conversion, specification, 用于把随后对应的0个或多个函数参数转换为相应的格式输出, 中转换说明以外的其它字符原样输出, 一个printf函数的例子, 目录, c语言printf函数为代表的一类, 格式化占位符, 类型, 具有printf风格函数的编程语言, 参考文献, 外部链接c语言pri. 格式化字符串 英語 format string 是一些程序设计语言的输入 输出库中能將字符串参数轉換為另一種形式輸出的函数 例如C C 等程序设计语言的printf类函数 其中的转换说明 conversion specification 用于把随后对应的0个或多个函数参数转换为相应的格式输出 格式化字符串中转换说明以外的其它字符原样输出 1 一个printf函数的例子 目录 1 C语言printf函数为代表的一类 1 1 格式化占位符 1 2 类型 1 3 具有printf风格函数的编程语言 2 参考文献 3 外部链接C语言printf函数为代表的一类 编辑格式化占位符 编辑 格式化字符串中的占位符用于指明输出的参数值如何格式化 格式化占位符 format placeholder 语法是 i parameter i i flags i i field width i i precision i i length i i type i Parameter可以忽略或者是 字符 描述 i n i n是用这个格式说明符 specifier 显示第几个参数 这使得参数可以输出多次 使用多个格式说明符 以不同的顺序输出 如果任意一个占位符使用了parameter 则其他所有占位符必须也使用parameter 这是POSIX扩展 不属于ISO C 例 printf 2 d 2 x 1 d 1 x 16 17 产生 17 0x11 16 0x10 Flags可为0个或多个 字符 描述 总是表示有符号数值的 或 号 缺省情况是忽略正数的符号 仅适用于数值类型 空格 使得有符号数的输出如果没有正负号或者输出0个字符 则前缀1个空格 如果空格与 同时出现 则空格说明符被忽略 左对齐 缺省情况是右对齐 对于 g 与 G 不删除尾部0以表示精度 对于 f F e E g G 总是输出小数点 对于 o x X 在非0数值前分别输出前缀0 0x and 0X表示数制 0 如果width选项前缀以0 则在左侧用0填充直至达到宽度要求 例如printf 2d 3 输出 3 而printf 02d 3 输出 03 如果0与 均出现 则0被忽略 即左对齐依然用空格填充 Field Width给出显示数值的最小宽度 典型用于制表输出时填充固定宽度的表目 实际输出字符的个数不足域宽 则根据左对齐或右对齐进行填充 实际输出字符的个数超过域宽并不引起数值截断 而是显示全部 宽度值的前导0被解释为0填充标志 如上述 前导的负值被解释为其绝对值 负号解释为左对齐标志 如果域宽值为 则由对应的函数参数的值为当前域宽 Precision通常指明输出的最大长度 依赖于特定的格式化类型 对于d i u x o的整型数值 是指最小数字位数 不足的位要在左侧补0 如果超过也不截断 缺省值为1 对于a A e E f F的浮点数值 是指小数点右边显示的数字位数 必要时四舍五入或补0 缺省值为6 对于g G的浮点数值 是指有效数字的最大位数 缺省值为6 对于s的字符串类型 是指输出的字节的上限 超出限制的其它字符将被截断 如果域宽为 则由对应的函数参数的值为当前域宽 如果仅给出了小数点 则域宽为0 Length指出浮点型参数或整型参数的长度 此项Microsoft称为 Size 可以忽略 或者是下述 字符 描述hh 对于整数类型 printf期待一个从char提升的int尺寸的整型参数 h 对于整数类型 printf期待一个从short提升的int尺寸的整型参数 l 对于整数类型 printf期待一个long尺寸的整型参数 对于浮点类型 printf期待一个double尺寸的整型参数 对于字符串s类型 printf期待一个wchar t指针参数 对于字符c类型 printf期待一个wint t型的参数 ll 对于整数类型 printf期待一个long long尺寸的整型参数 Microsoft也可以使用I64 L 对于浮点类型 printf期待一个long double尺寸的整型参数 z 对于整数类型 printf期待一个size t尺寸的整型参数 j 对于整数类型 printf期待一个intmax t尺寸的整型参数 t 对于整数类型 printf期待一个ptrdiff t尺寸的整型参数 此外 在ISO C99广泛接受前 还有几个平台相关的length选项 字符 描述I 对于有符号整数类型 printf期待一个ptrdiff t尺寸的整型参数 对于无符号整数类型 printf期待一个size t尺寸的整型参数 常见于Win32 Win64平台 I32 对于整数类型 printf期待一个32位 双字 的整型参数 常见于Win32 Win64平台 I64 对于整数类型 printf期待一个64位 四字 的整型参数 常见于Win32 Win64平台 q 对于整数类型 printf期待一个64位 四字 的整型参数 常见于BSD平台 ISO C99的头文件 a href Inttypes h html title Inttypes h inttypes h a 包含了许多宏 用于平台独立的printf编码 例如 宏 定义PRId32 典型地等效于I32d Win32 Win64 或dPRId64 典型地等效于I64d Win32 Win64 lld 32位平台 或ld 64位平台 PRIi32 典型地等效于I32i Win32 Win64 或iPRIi64 典型地等效于I64i Win32 Win64 lli 32位平台 或li 64位平台 PRIu32 典型地等效于I32u Win32 Win64 或uPRIu64 典型地等效于I64u Win32 Win64 llu 32位平台 或lu 64位平台 PRIx32 典型地等效于I32x Win32 Win64 或xPRIx64 典型地等效于I64x Win32 Win64 llx 32位平台 或lx 64位平台 类型 编辑 Type 也称转换说明 conversion specification specifier 可以是 字符 描述d i 有符号十进制数值int d 与 i 对于输出是同义 但对于 a href Scanf html class mw redirect title Scanf scanf a 输入二者不同 其中 i在输入值有前缀0x或0时 分别表示16进制或8进制的值 如果指定了精度 则输出的数字不足时在左侧补0 默认精度为1 精度为0且值为0 则输出为空 u 十进制unsigned int 如果指定了精度 则输出的数字不足时在左侧补0 默认精度为1 精度为0且值为0 则输出为空 f F double型输出10进制定点 英语 Fixed point arithmetic 表示 f 与 F 差异是表示无穷与NaN时 f 输出 inf infinity 与 nan F 输出 INF INFINITY 与 NAN 小数点后的数字位数等于精度 最后一位数字四舍五入 精度默认为6 如果精度为0且没有 标记 则不出现小数点 小数点左侧至少一位数字 e E double值 输出形式为10进制的 d ddd e ddd E版本使用的指数符号为E 而不是e 指数部分至少包含2位数字 如果值为0 则指数部分为00 Windows系统 指数部分至少为3位数字 例如1 5e002 也可用Microsoft版的运行时函数 set output format 修改 小数点前存在1位数字 小数点后的数字位数等于精度 精度默认为6 如果精度为0且没有 标记 则不出现小数点 g G double型数值 精度定义为全部有效数字位数 当指数部分在闭区间 4 5 内 输出为定点形式 否则输出为指数浮点形式 g 使用小写字母 G 使用大写字母 小数点右侧的尾数0不被显示 显示小数点仅当输出的小数部分不为0 x X 16进制unsigned int x 使用小写字母 X 使用大写字母 如果指定了精度 则输出的数字不足时在左侧补0 默认精度为1 精度为0且值为0 则输出为空 o 8进制unsigned int 如果指定了精度 则输出的数字不足时在左侧补0 默认精度为1 精度为0且值为0 则输出为空 s 如果没有用l标志 输出null结尾字符串 英语 null terminated string 直到精度规定的上限 如果没有指定精度 则输出所有字节 如果用了l标志 则对应函数参数指向wchar t型的数组 输出时把每个宽字符转化为多字节字符 相当于调用wcrtomb函数 c 如果没有用l标志 把int参数转为unsigned char型输出 如果用了l标志 把wint t参数转为包含两个元素的wchart t数组 其中第一个元素包含要输出的字符 第二个元素为null宽字符 p void 型a A double型的16进制表示 0xh hhhh p d 其中指数部分为10进制表示的形式 例如 1025 010输出为0x1 004000p 10 a 使用小写字母 A 使用大写字母 2 3 C 11流使用hexfloat输出16进制浮点数 n 不输出字符 但是把已经成功输出的字符个数写入对应的整型指针参数所指的变量 字面值 不接受任何flags width precision or length 宽度与精度格式化参数可以忽略 或者直接指定 或者用星号 表示取对应函数参数的值 例如printf d 5 10 输出 10 printf s 3 abcdef 输出 abc 如果函数参数太少 不能匹配所有的格式参数说明符 或者函数参数的类型不匹配 将导致未定义 undefined 行为 过多的函数参数被忽略 许多时候 未定义的行为将导致格式化字符串攻击 英语 Format string attack 某些编译器 如GCC 会静态检查printf这一类函数的格式化参数并编译警告存在的问题 当使用编译标志 Wall或 Wformat GCC也会对用户自定义的printf风格函数做静态检查 如果在函数定义时使用了非标准的 attribute format 具有printf风格函数的编程语言 编辑 AMPL awk 通过sprintf Bourne shell sh 以及变种Korn shell ksh Bourne again shell bash Z shell zsh C C 以及iostream与iomanip输出操作 Objective C Clojure Common Lisp D F GNU MathProg GNU Octave G LabVIEW Go Haskell Java 版本1 5开始 在PrintStream类提供了printf函数 Clojure Scala Lua string format Maple Mathematica MATLAB Mythryl OCaml OCaml Batteries Included provides an additional user extensible printf PARI GP 英语 PARI GP PHP Perl Python 使用 操作符 2 6版以后提供了format方法 R Ruby Rust Tcl 通过format命令 Transact SQL 通过xp sprintf 页面存档备份 存于互联网档案馆 Vala 通过print 与FileStream printf 此外 Windows API的FormatMessage函数也使用格式化字符串说明 参考文献 编辑 C11 standard n1570 draft 7 21 6 1 3 pp309 The GNU C Library Reference Manual 12 12 3 Table of Output Conversions Gnu org 2014 03 17 原始内容存档于2021 03 27 printf 页面存档备份 存于互联网档案馆 a added in C99 外部链接 编辑C reference for std fprintf 页面存档备份 存于互联网档案馆 gcc printf format specifications quick reference 页面存档备份 存于互联网档案馆 printf print formatted output 系统界面 System Interfaces 参考 单一UNIX 规范第7期 由國際開放標準組織发布 The Formatter specification 页面存档备份 存于互联网档案馆 in Java 1 5 GNU Bash printf 1 builtin 页面存档备份 存于互联网档案馆 取自 https zh wikipedia org w index php title 格式化字符串 amp oldid 69403837, 维基百科，wiki，书籍，书籍，图书馆，

文章

，阅读，下载，免费，免费下载，mp3，视频，mp4，3gp， jpg，jpeg，gif，png，图片，音乐，歌曲，电影，书籍，游戏，游戏。