各种
printf
和
wprintf
函数采用格式字符串和可选参数，并生成用于输出的格式化字符序列。 格式字符串包含零个或多个指令
，这些指令是用于输出的文本字符或描述如何在输出中设置参数格式的已编码的转换规范
。 本文介绍用于对格式字符串中的转换规范进行编码的语法。 有关这些函数的列表，请参阅
流 I/O
。
一个转换规范由以下形式的可选和必需字段组成：
%
[
标志
][
宽度
][.
精度
][
大小
]
类型
转换规范的每个字段都是一个用于指示特定的格式选项或转换说明符的字符或数字。 必填的类型
字段指定要应用于参数的转换类型。 可选的
标志
、
宽度
和
精度
字段控制格式的其他方面（如前导空格或前导零、对齐方式和显示的精度）。 大小
字段指定使用和转换的参数的大小。
一个基本的转换规范仅包含百分号和一个类型
字符。 例如，
%s
指定一个字符串转换。 若要打印百分号字符，请使用
%%
。 如果百分号后跟一个没有任何意义的字符作为格式字段，则将调用无效的参数处理程序。 有关详细信息，请参阅
参数验证
。
为了实现安全性和稳定性，请确保格式转换规范字符串不是最终用户定义的。 例如，考虑这样一个程序，它提示用户输入名称并将输入存储在一个名为
user_name
的字符串变量中。 若要打印
user_name
，切勿执行以下操作：
printf( user_name ); /* Danger! If user_name contains "%s", program will crash */
而应执行以下操作：
printf( "%s", user_name );
在 Visual Studio 2015 中，
printf
函数和
scanf
函数系列已声明为
inline
并移至
<stdio.h>
和
<conio.h>
标头。 如果正在迁移较旧的代码，则可能会发现 LNK2019 与这些函数相关。 有关详细信息，请参阅
Visual C++ 更改历史记录 2003 - 2015
。
类型转换说明符
类型
转换说明符字符指定是否要将相应的参数解释为字符、字符串、指针、整数或浮点数。 类型
字符是唯一必填的转换规范字段，它出现在任何可选字段之后。
将根据相应的类型
字符和可选的
大小
前缀对紧跟格式字符串的参数进行解释。 通过使用
c
或
C
，指定字符类型
char
和
wchar_t
的转换，通过使用
s
或
S
指定单字节和多字节或宽字符字符串，具体取决于正在使用的格式设置函数。 通过使用
c
和
s
指定的字符和字符串自变量被
printf
系列函数解释为
char
和
char*
，或被
wprintf
系列函数解释为
wchar_t
和
wchar_t*
。 通过使用
C
和
S
指定的字符和字符串自变量被
printf
系列函数解释为
wchar_t
和
wchar_t*
，或被
wprintf
系列函数解释为
char
和
char*
。 此行为是 Microsoft 专用的。 出于历史原因，
wprintf
函数使用
c
和
s
来引用
wchar_t
字符，使用
C
和
S
来指定窄字符。
通过使用
d
、
i
、
o
、
u
、
x
和
X
指定整数类型（如
short
、
int
、
long
、
long long
）以及其
unsigned
变体。 通过使用
a
、
A
、
e
、
E
、
f
、
F
、
g
和
G
指定浮点类型（如
float
、
double
和
long double
）。 默认情况下，除非由大小
前缀进行修改，否则整数参数将被强制为
int
类型，浮点参数将被强制为
double
。 在 64 位系统上，
int
是 32 位的值；因此，确定 64 位整数的输出格式时，将把它截断，除非使用
ll
或
I64
的
大小
前缀。 由
p
指定的指针类型使用平台的默认指针大小。
Microsoft 专用：
与
printf
和
wprintf
函数一起使用时，
Z
类型字符以及
c
、
C
、
s
和
S
类型字符的行为是 Microsoft 扩展。 在所有的格式设置函数中，ISO C 标准始终对窄字符和字符串使用
c
和
s
，而对宽字符和字符串使用
C
和
S
。
类型字段字符
有符号的值，形式为 [
-
]
d.dddd
e
[
+
|
-
]
dd
[
d
]，其中
d
是一个十进制数，
dddd
是一个或多个十进制数（具体取决于指定的精度），或为默认的六个数，
dd
[
d
] 是两个或三个十进制数（具体取决于
输出格式
和指数大小）。
与
e
格式相同，除非
E
（而非
e
）引入了指数。
有符号的值，形式为 [
-
]
dddd
.
dddd
，其中
dddd
是一个或多个十进制数。 小数点前的数字位数取决于数字的度量值，小数点后的数字位数取决于请求的精度，或为默认的六位数。
与
f
格式相同，只不过 infinity 和 NAN 输出为大写形式。
有符号的值显示为
f
或
e
格式，取其中对于给定的值和精度更为精简一个。 仅当值的指数小于 -4 或大于等于 precision 参数时，才使用
e
格式。
截去尾随零，仅当后跟一个或多个数字时，才会显示小数点。
与
g
格式相同，除非
E
（而非
e
）引入指数（如果适用）。
有符号的十六进制双精度浮点值，形式为 [
-
]
0x
h.hhhh
p
[
+
|
-
]
dd
，其中
h.hhhh
是尾数的十六进制数（使用小写字母），
dd
是一位或多位指数。 精度指定此点后的数字位数。
有符号的十六进制双精度浮点值，形式为 [
-
]
0X
h.hhhh
P
[
+
|
-
]
dd
，其中
h.hhhh
是尾数的十六进制数（使用大写字母），
dd
是一位或多位指数。 精度指定此点后的数字位数。
指向整数的指针
目前成功写入流或缓冲区的字符数。 此值存储在地址作为自变量的整数中。 可通过参数大小规范前缀控制指向的整数的大小。
n
说明符默认为禁用；请参阅重要的安全说明了解相关信息。
将自变量显示为十六进制数中的地址。
与
printf
函数一起使用时，指定单字节或多字节字符串；与
wprintf
函数一起使用时，指定宽字符字符串。 将于第一个空字符之前或达到精度
值时显示字符。
与
printf
函数一起使用时，指定宽字符字符串；与
wprintf
函数一起使用时，指定单字节或多字节字符串。 将于第一个空字符之前或达到精度
值时显示字符。
ANSI_STRING
或
UNICODE_STRING
结构
VS 2013 及更低版本
将
ANSI_STRING
或
UNICODE_STRING
结构的地址作为参数传递时，会显示包含在由结构的
Buffer
字段指向的缓冲区中的字符串。 使用
w
的 size 修饰符前缀指定
UNICODE_STRING
参数，例如
%wZ
。
结构的
Length
字段必须设置为字符串的长度（以字节为单位）。 结构的
MaximumLength
字段必须设置为缓冲区的长度（以字节为单位）。
通用 C 运行时 (UCRT)
UCRT 中存在一个已知问题，目前为了兼容性而保留。 与
S
说明符一样，使用窄打印函数（如
printf
）时，没有大小修饰符前缀的
Z
说明符是指
UNICODE_STRING
，使用宽打印函数（如
wprintf
）时是指
ANSI_STRING
。
使用
hZ
指定
ANSI_STRING
，而不是使用
Z
。
wZ
（或
lZ
）仍可用于指定一个
UNICODE_STRING
。
通常情况下，
Z
类型字符仅在使用转换规范的驱动程序调试函数（如
dbgPrint
和
kdPrint
）中使用。
在 Visual Studio 2015 及更高版本中，如果对应浮点转换说明符（
a
、
A
、
e
、
E
、
f
、
F
、
g
和
G
）的自变量为无穷大、不定或 NAN，则格式化的输出符合 C99 标准。 下表列出了格式化的输出：
可能以符号作为其中任何一个字符串的前缀。 如果浮点类型
转换说明符字符是一个大写字母，则输出也将使用大写字母格式。 例如，如果格式说明符是
%F
而不是
%f
，则 infinity 的格式将被设置为
INF
，而不是
inf
。
scanf
函数也可以分析这些字符串，使这些值可以通过
printf
和
scanf
函数进行往返。
在 Visual Studio 2015 之前，CRT 使用一种不同的非标准格式作为无穷大、不定和 NaN 值的输出：
其中任何一个字符串都可能已采用符号作为前缀并且格式设置也可能有所不同，具体取决于字段宽度和精度，有时会起到不寻常的作用。 例如，
printf("%.2f\n", INFINITY)
可以打印
1.#J
，因为 #INF 会“四舍五入”到 2 位数的精度。
如果与
%s
或
%S
对应的参数，或与
%Z
对应的参数的
Buffer
字段为空指针，则将显示“(null)”。
在所有的指数格式中，要显示的指数的位数最少为两位，仅在必要时使用三位。 通过使用
_set_output_format
函数，可以将显示的数字位数设置为三位，以确保与为 Visual Studio 2013 及更早版本编写的代码的后向兼容性。
%n
格式在本质上是不安全的，因此它默认处于禁用状态。 如果在格式字符串中遇到
%n
，则将调用无效的参数处理程序，如
参数验证
中所述。 要启用
%n
支持，请参阅
_set_printf_count_output
。
转换规范中的第一个可选字段包含
标志指令
。 该字段包含零个或多个标志字符，用于指定输出对齐方式以及控制符号、空白、前导零、小数点以及八进制和十六进制前缀的输出。 转换规范中可能会出现多个标志指令，并且标志字符可能会按任意顺序出现。
如果将
0
作为宽度的前缀，则会在达到最小宽度前添加前导零。
如果同时出现
0
和
-
，则将忽略
0
。 如果为整数格式（
i
、
u
、
x
、
X
、
o
和
d
）指定了
0
，并且还存在精度规范（例如
%04.d
），则
0
将被忽略。 如果为
a
或
A
浮点格式指定了
0
，则会在
0x
或
0X
前缀后，在尾数前追加前导零。
blank (' ')
如果输出值为有符号的正值，则使用空白作为其前缀。 如果空白和 + 标志同时出现，空白则将被忽略。
没有显示空白。
与
o
、
x
或
X
格式一起使用时，
#
标志将分别使用
0
、
0x
或
0X
作为任何非零输出值的前缀。
没有出现前缀。
与
e
、
E
、
f
、
F
、
a
或
A
格式一起使用时，
#
标志将强制输出值包含小数点。
仅当小数点后紧跟数字时，才会显示小数点。
与
g
或
G
格式一起使用时，
#
标志将强制输出值包含小数点，并阻止截断尾随零。
与
c
、
d
、
i
、
u
或
s
一起使用时忽略。
仅当小数点后紧跟数字时，才会显示小数点。 尾随零将被截断。
在转换规范中，可选宽度规范字段出现在任何标志
字符之后。
width
参数是控制最小输出字符数量的非负十进制整数。 如果输出值中的字符数小于指定宽度，则将在值的左侧或右侧添加空白（具体取决于是否指定了左对齐标志 (
-
)），直到达到最小宽度为止。 如果
width
的前缀为 0，则将向整数或浮点转换添加前导零，直到到达最小宽度，但转换到无穷大或
NaN
时除外。
宽度规范永远不会导致值被截断。 如果输出值中的字符数大于指定宽度，或如果未提供
width
，则将根据精度规范输出值中的所有字符。
如果宽度规范是一个星号 (
*
)，则参数列表中的
int
参数将提供此值。
width
参数前必须是已在参数列表中进行格式设置的值，如以下示例所示：
printf("%0*d", 5, 3); /* 00003 is output */
转换规范中缺少
width
值或此值较小将不会导致截断输出值。 如果转换结果宽于
width
值，则字段将扩展以包含转换结果。
在转换规范中，第三个可选字段是精度规范。 它包含一个句点 (
.
)，后跟一个非负十进制整数，指定字符串字符数、小数位数或要输出的有效数字位数，具体取决于转换类型.
与宽度规范不同的是，精度规范可能导致输出值截断或浮点值舍入。 如果
precision
被指定为 0 且要转换的值为 0，则结果为无字符输出，如以下示例中所示：
printf( "%.0d", 0 ); /* No characters output */
如果精度规范是一个星号 (
*
)，则参数列表中的某个
int
参数将提供此值。 在参数列表中，
precision
参数前必须先于已格式设置的值，如以下示例所示：
printf( "%.*f", 3, 3.14159265 ); /* 3.142 output */
省略
precision
时，
type
字符决定
precision
的解释或默认精度，如下表所示。
精度值如何影响类型
d
,
i
,
o
,
u
,
x
,
X
精度指定要打印的最小数字位数。 如果参数中的数字位数小于精度
，则将在输出值的左侧使用零进行填充。 数字位数超过 precision 时，值将不会被截断。
默认精度为 1。
e
，
E
精度指定此小数点后要打印的数字位数。 打印的最后一位数舍入。
默认精度为 6。 如果精度为 0，或者如果句点 (
.
) 后面不跟数字，则不会打印小数点。
f
，
F
精度值指定此小数点后的数字位数。 如果出现小数点，则在它之前至少会显示一个数字。 该值舍入为适当数量的数字。
默认精度为 6。 如果精度
为 0，或者如果句点 (
.
) 后面不跟数字，则不会打印小数点。
g
，
G
精度指定打印的最大有效位数。
打印六个有效位数，并且任何尾随零都会被截断。
s
，
S
精度指定要打印的最大字符数。 不会打印超过精度
的字符。
在找到 null 字符之前不会打印字符。
参数大小规范
在转换规范中，大小
字段是类型
转换说明符的参数长度修饰符。 size 字段作为 type 字段（
hh
、
h
、
j
、
l
（小写的 L）、
L
、
ll
、
t
、
w
、
z
、
I
（大写的 i）、
I32
和
I64
）的前缀，根据它们修饰的转换说明符，指定对应参数的“大小”（长型或短型、32 位或 64 位、单字节字符或宽字符）。
这些大小前缀在
printf
和
wprintf
系列函数中与
类型
字符一起使用，以指定参数大小的解释（如下表中所示）。 大小
字段对于某些参数类型是可选的。 未指定任何大小前缀时，格式化程序使用整数参数（例如，有符号或无符号的
char
、
short
、
int
、
long
和枚举类型）作为 32 位
int
类型，而使用
float
、
double
和
long double
浮点参数作为 64 位
double
类型。 此行为与变量自变量列表的默认自变量提升规则相匹配。 有关自变量提升的详细信息，请参阅
后缀表达式
中的“省略号和默认参数”。 在 32 位和 64 位系统上，64 位整数参数的转换规范必须包含
ll
或
I64
大小前缀。 否则，格式化程序的行为是不明确的。
某些类型在 32 位和 64 位代码中具有不同大小。 例如，
size_t
在针对 x86 编译的代码中是 32 位长，而在针对 x64 编译的代码中是 64 位。 若要为宽度可变的类型创建与平台无关的格式设置代码，可以使用宽度可变的参数大小修饰符。 改为使用 64 位参数大小修饰符，并将宽度可变的参数类型显式提升为 64 位。 特定于 Microsoft 的
I
（大写的 i）参数大小修饰符可处理宽度可变的整数参数，但我们建议使用特定于类型的
j
、
t
和
z
修饰符以确保可移植性。
及类型说明符
ptrdiff_t
和
size_t
类型在 32 位平台上为
__int32
或
unsigned __int32
，在 64 位平台上为
__int64
或
unsigned __int64
。
I
（大写的 i）、
j
、
t
和
z
大小前缀采用平台的正确参数宽度。
在 Visual C++ 中，虽然
long double
是互异的类型，但是它具有与
double
相同的内部表示形式。
hc
或
hC
类型说明符与
printf
函数中的
c
以及
wprintf
函数中的
C
是同义的。
lc
、
lC
、
wc
或
wC
类型说明符与
printf
函数中的
C
以及
wprintf
函数中的
c
是同义的。
hs
或
hS
类型说明符与
printf
函数中的
s
以及
wprintf
函数中的
S
是同义的。
ls
、
lS
、
ws
或
wS
类型说明符与
printf
函数中的
S
以及
wprintf
函数中的
s
是同义的。
Microsoft 专用：
I
（大写的 i）、
I32
、
I64
和
w
参数大小修饰符前缀是 Microsoft 扩展，且不符合 ISO C。
h
前缀（在与
char
类型的数据一起使用时）和
l
（小写 L）前缀（在与
double
类型的数据一起使用时）是 Microsoft 扩展。
printf
、
_printf_l
、
wprintf
、
_wprintf_l
printf_s
、
_printf_s_l
、
wprintf_s
、
_wprintf_s_l
printf_p
位置参数
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：
https://aka.ms/ContentUserFeedback
。
提交和查看相关反馈
