在本文中将讲述printf/wprintf/CString.Format等相关函数所使用的格式化输出的语法。
函数中格式化声明的一般格式为：
%[flags] [width] [.precision] [{h | l | ll | I | I32 | I64}]type
其中的每一个蓝色项都代表了格式化输出格式中的一个选项。这些输出格式选项一般使用一个字母或者一个数字来表示特定的格式；该格式说明语句最简单的形式就是百分号%加上一个类型说明符type，例如%s。如果%后跟的字符并非type类型的选项之一，那么这个字符将以文本的形式输出。例如在输出百分号时所采用的语句%%。
出现在type之前的其他选项都分别控制了格式化输出的其他方面，具体如下：
| character | Type | Output format |
|---|---|---|
| c | int or wint_t | 用在printf函数中，表示的是一个single-byte字符；而用在wprintf函数中，表示的是一个宽字符。 |
| C | int or wint_t | 用在wprintf函数中，表示的是一个single-byte字符；而用在printf函数中，表示的是一个宽字符。(与c刚好相反) |
| d | int | 有符号十进制整数 |
| i | int | 有符号十进制整数 |
| o | int | 八进制无符号整数 |
| u | int | 无符号十进制整数 |
| x | int | 无符号十六进制整数，使用"abcdef"标识。 |
| X | int | 无符号十六进制整数，使用"ABCDEF"标识。 |
| e | double | 有符号值，输出形式为[ – ]d.dddd e [sign]dd[d]。其中d是一个十进制的数字，其范围为0-9；dddd是一个或者多个十进制的数字。dd[d]是两个或者三个十进制的数字。其值依赖于输出的格式和指数的大小。符号是+、-。 |
| E | double | 和e相似，只是将输出中的e用E代替。 |
| f | double | 有符号值，输出形式为[-]dddd.dddd。小数点前面的数字由输出值的大小决定。而小数点后面的数字由输出的精度决定。 |
| g | double | Signed value printed in f or e format, whichever is more compact for the given value and precision. The e format is used only when the exponent of the value is less than –4 or greater than or equal to the precision argument. Trailing zeros are truncated, and the decimal point appears only if one or more digits follow it. |
| G | double | Identical to the g format, except that E, rather than e, introduces the exponent (where appropriate). |
| a | double | 有符号双精度十六进制浮点数。输出形式为[−]0xh.hhhh p±dd。precision选项将决定小数点后面的位数。(using lower case letters) |
| A | double | 有符号双精度十六进制浮点数。输出形式为[−]0xh.hhhh P±dd。precision选项将决定小数点后面的位数。(using capital letters) |
| n | Pointer to integer | Number of characters successfully written so far to the stream or buffer; this value is stored in the integer whose address is given as the argument. See Security Note below. |
| p | Pointer to void | 以十六进制的形式输出地址 |
| s | String | 当和printf函数使用的时候，输出的是single-byte字符串。而和wprintf使用的时候输出的是宽字符串；会依次输出所有字符知道遇到第一个null字符或者由precision值限定； |
| S | String | 当和wprintf函数使用的时候，输出的是single-byte字符串。而和printf使用的时候输出的是宽字符串；会依次输出所有字符知道遇到第一个null字符或者由precision值限定； |
Note：如果和%s或者%S相关的参数是一个null指针，将会输出“(null)”.
Note：在所有的指数格式中，默认的指数位数为3位；可以利用函数_set_output_format设定输出的位数为2，然后输出会根据需要扩展到3位。
Security Note： %n格式符是不安全的，在默认情况下是被禁用的;利用_set_printf_count_output函数可以启用该功能。
附录2
The optional prefixes to type, h, l, I, I32, I64, and ll specify the "size" of argument (long or short, 32- or 64-bit, single-byte character or wide character, depending upon the type specifier that they modify). These type-specifier prefixes are used with type characters in printf functions or wprintf functions to specify interpretation of arguments, as shown in the following table. These prefixes are Microsoft extensions and are not ANSI-compatible.
| NOTE: |
|---|
| The h and l prefixes are Microsoft extensions when used with data of type char. |
| To specify | Use prefix | With type specifier |
|---|---|---|
| long int | l (lowercase L) | d, i, o, x, or X |
| long unsigned int | l | o, u, x, or X |
| long long | ll | d, i, o, x, or X |
| short int | h | d, i, o, x, or X |
| short unsigned int | h | o, u, x, or X |
| __int32 | I32 | d, i, o, x, or X |
| unsigned __int32 | I32 | o, u, x, or X |
| __int64 | I64 | d, i, o, x, or X |
| unsigned __int64 | I64 | o, u, x, or X |
| ptrdiff_t (that is, __int32 on 32-bit platforms, __int64 on 64-bit platforms) | I | d, i, o, x, or X |
| size_t (that is, unsigned __int32 on 32-bit platforms, unsigned __int64 on 64-bit platforms) | I | o, u, x, or X |
| long double | l or L | f |
| Single-byte character with printf functions | h | c or C |
| Single-byte character with wprintf functions | h | c or C |
| Wide character with printf functions | l | c or C |
| Wide character with wprintf functions | l | c or C |
| Single-byte – character string with printf functions | h | s or S |
| Single-byte – character string with wprintf functions | h | s or S |
| Wide-character string with printf functions | l | s or S |
| Wide-character string with wprintf functions | l | s or S |
| Wide character | w | c |
| Wide-character string | w | s |
Thus to print single-byte or wide-characters with printf functions and wprintf functions, use format specifiers as follows.
| To print character as | Use function | With format specifier |
|---|---|---|
| single byte | printf | c, hc, or hC |
| single byte | wprintf | C, hc, or hC |
| wide | wprintf | c, lc, lC, or wc |
| wide | printf | C, lc, lC, or wc |
To print strings with printf functions and wprintf functions, use the prefixes h and l analogously with format type-specifiers s and S.