缓冲

-

指向要写入的字符串的指针

bufsz

-

最多bufsz - 可能会写入1个字符，再加上空终止符

格式

-

指向以空字符结尾的多字节字符串的指针，指定如何解释数据。

格式字符串由普通的多字节字符（除外%）组成，它们被不变地复制到输出流和转换规范中。每个转换规范具有以下格式：

介绍%人物

（可选）一个或多个修改转换行为的标志：

-：转换的结果在字段内左对齐（默认情况下它是右对齐的）

+：带符号转换的符号总是预设为转换结果的前缀（默认情况下结果前面为减号，仅当它为负值时）

空格：如果签名转换的结果不是以符号字符开头，或者是空的，则空格会预设为结果。如果+标志存在，它将被忽略。

#：执行转换的替代形式。请参阅下表以了解确切的效果，否则行为未定义。

0：对于整数和浮点数转换，前导零用于填充字段而不是空格字符。对于整数，如果明确指定了精度，它将被忽略。对于使用此标志的其他转换会导致未定义的行为。如果-标志存在，它将被忽略。

（可选）整数值或*指定最小字段宽度。如果需要，结果会填充空格字符（默认情况下），右侧对齐时填充空白字符，左侧填充右侧填充。在使用的情况下*，宽度由类型的附加参数指定int。如果参数的值是负数，则结果是-指定的标志和正的字段宽度。（注意：这是最小宽度：该值从不被截断。）

（可选） .后面跟随整数或者*或者既不指定转换的精度。在使用的情况下*，精度由类型的附加参数指定int。如果这个参数的值是负数，它将被忽略。如果既不使用数字也不*使用，则精度取为零。请参阅下表以了解精确度的确切影响。

（可选） 长度修饰符，用于指定参数的大小

转换格式说明符

以下格式说明符可用：

转换

说明

参数类型

说明符

长度修饰符

hh

h

（没有）

l

ll

j

z

t

L

（C99）。

（C99）。

（C99）。

（C99）。

（C99）。

%

写文字%。完整的转换规范必须是%%。

N / A

N / A

N / A

N / A

N / A

N / A

N / A

N / A

N / A

c

写一个字符。

N / A

N / A

int

wint_t

N / A

N / A

N / A

N / A

N / A

该论点首先转换为unsigned char。如果使用了l修饰符，则首先将参数转换为字符串，就像通过具有参数的％ls一样wchar_t[2]。

s

写入一个字符串

N / A

N / A

char*

wchar_t*

N / A

N / A

N / A

N / A

N / A

参数必须是指向字符数组的初始元素的指针。Precision指定要写入的最大字节数。如果未指定Precision，则将每个字节写入并不包括第一个空终止符。如果使用了l说明符，则参数必须是指向数组初始元素的指针wchar_t，它将转换为char数组，就像通过调用wcrtomb具有零初始化转换状态一样。

d

将有符号整数转换为十进制表示形式[ - ] dddd。

signed char

short

int

long

long long

intmax_t

签 size_t

ptrdiff_t

N / A

i

精度指定出现的最小位数。默认的精度是1。

如果转换后的值和精度都是​0​没有字符的转换结果。

o

将无符号整数转换为八进制表示oooo。

unsigned char

unsigned short

unsigned int

unsigned long

unsigned long long

uintmax_t

size_t

未签名的版本 ptrdiff_t

N / A

精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是​0​没有字符的转换结果。在替代实现中，如果需要，可以增加精度以写入一个前导零。在这种情况下，如果转换后的值和精度都是​0​，​0​写入单个。

x

将无符号整数转换为十六进制表示hhhh。

N / A

X

使用x转换字母abcdef。

使用X转换字母ABCDEF。

精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是​0​没有字符的转换结果。在替代实现中， 0x或者0X如果转换后的值不为零，则将其作为结果的前缀。

u

将无符号整数转换为十进制表示形式dddd。

N / A

精度指定出现的最小位数。默认的精度是1。如果转换后的值和精度都是​0​没有字符的转换结果。

f

将浮点数转换为样式[ - ] ddd.ddd中的十进制表示法。

N / A

N / A

double

double（C99）

N / A

N / A

N / A

N / A

long double

F

精度指定小数点后面出现的最小位数。默认的精度是6。在替代实现中，即使没有数字跟随，小数点字符也会被写入。对于无穷大和非数字转换风格，请参阅注释。

e

将浮点数转换为十进制指数符号。

N / A

N / A

N / A

N / A

N / A

N / A

E

对于e转换样式，使用[ - ] d.ddd e±dd。

对于E转换样式，使用[ - ] d.ddd E±dd。

指数至少包含两位数字，只有在必要时才使用更多数字。如果值是​0​，指数也是​0​。精度指定小数点后面出现的最小位数。默认的精度是6。在替代实现中，即使没有数字跟随，小数点字符也会被写入。对于无穷大和非数字转换风格，请参阅注释。

a

将浮点数转换为十六进制指数表示法。

N / A

N / A

N / A

N / A

N / A

N / A

A

对于a转换样式，使用[ - ] 0xh.hhh p±d。

（C99）。

对于A转换样式，使用[ - ] 0Xh.hhh P±d。如果参数不是标准化的浮点值，则

第一个十六进制数字是0。如果值是​0​，指数也是​0​。精度指定小数点后面出现的最小位数。默认精度足以精确表示值。在替代实现中，即使没有数字跟随，小数点字符也会被写入。对于无穷大和非数字转换风格，请参阅注释。

g

根据值和精度将浮点数转换为十进制或十进制指数符号。

N / A

N / A

N / A

N / A

N / A

N / A

G

对于g风格转换的转换与风格e或f将被执行。

对于G风格转换的转换与风格E或F将被执行。

让P等于精度如果非零，6如果没有指定精度，或者1如果精度是​0​。然后，如果具有样式的转换E将具有以下指数X：

如果P> X≥-4，转换是用式f或F和精度P - 1 - X。

否则，转换采用样式e或E精度P - 1。

除非请求替代表示，否则尾随零将被删除，如果没有剩余小数部分，小数点字符也会被删除。对于无穷大和非数字转换风格，请参阅注释。

n

将此调用到目前为止写入的字符数返回给该函数。

signed char*

short*

int*

long*

long long*

intmax_t*

签 size_t*

ptrdiff_t*

N / A

结果写入参数指向的值。规范可能不包含任何标志，字段宽度或精度。

p

写一个实现定义的字符序列来定义一个指针。

N / A

N / A

void*

N / A

N / A

N / A

N / A

N / A

N / A

浮点转换函数将无穷大转换为inf或infinity。使用哪一个是实现定义的。

非数字转换为nan或。使用哪一个是实现定义的。nan(char_sequence)

该转换F，E，G，A输出INF，INFINITY，NAN来代替。

即使%c需要int参数，通过char调用可变参数函数时发生的整数提升也是安全的。

对于固定宽度的字符类型（正确的转换规格int8_t，等等）都在头中定义<inttypes.h>还（虽然PRIdMAX，PRIuMAX等是同义词%jd，%ju等）。

内存写入转换说明符%n是安全漏洞的常见目标，其中格式字符串取决于用户输入，并且不受边界检查printf_s函数族的支持。

每个转换说明符的操作之后都有一个序列点 ; 这允许将多个%n结果存储在相同的变量中，或者作为边缘情况，%n在相同的调用中打印由较早修改的字符串。

如果转换规范无效，则行为未定义。

...

-

指定要打印的数据的参数