printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s
定义于头文件 <stdio.h>
|
||
(1) | ||
int printf( const char *format, ... ); |
(C99 前) | |
int printf( const char *restrict format, ... ); |
(C99 起) | |
(2) | ||
int fprintf( FILE *stream, const char *format, ... ); |
(C99 前) | |
int fprintf( FILE *restrict stream, const char *restrict format, ... ); |
(C99 起) | |
(3) | ||
int sprintf( char *buffer, const char *format, ... ); |
(C99 前) | |
int sprintf( char *restrict buffer, const char *restrict format, ... ); |
(C99 起) | |
int snprintf( char *restrict buffer, int bufsz, const char *restrict format, ... ); |
(4) | (C99 起) |
int printf_s(const char *restrict format, ...); |
(5) | (C11 起) |
int fprintf_s(FILE *restrict stream, const char *restrict format, ...); |
(6) | (C11 起) |
int sprintf_s(char *restrict buffer, rsize_t bufsz, const char *restrict format, ...); |
(7) | (C11 起) |
int snprintf_s(char *restrict buffer, rsize_t bufsz, const char *restrict format, ...); |
(8) | (C11 起) |
从给定位置加载数据,转换为字符串等价物,并写结果到各种池。
stream
。buffer
。buffer
。至多写 buf_size
- 1 个字符。产生的字符串会以空字符终止,除非 buf_size
为零。若 buf_size
为零,则不写入任何内容,且 buffer
可以是空指针,然而依旧计算返回值(会写入的字符数,不包含空终止符)并返回。-
format
中存在转换说明符%n
- 任何一个对应
%s
的参数是空指针 -
format
或buffer
是空指针 -
bufsz
为零或大于 RSIZE_MAX - 在任何一个字符串及字符转换说明符中出现编码错误
- (仅对于
sprintf_s
)存储于buffer
的字符串(包括尾随空字符)长度将超出bufsz
-
- 同所有边界检查函数,
printf_s, fprintf_s, sprintf_s, snrintf_s
仅若实现定义了 __STDC_LIB_EXT1__ ,且用户在包含<stdio.h>
前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。
参数
stream | - | 要写入的输出文件流 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
buffer | - | 指向要写入的字符串的指针 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
bufsz | - | 最多会写入 bufsz - 1 个字符,再加空终止符 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | - | 指向指定数据转译方式的空终止多字节字符串的指针。
格式字符串由普通多字节字符(除了
下列格式指定符可用:
浮点转换函数转换无穷大到 非数转换成 转换 尽管 定宽整数类型( int8_t 等)的正确转换指定定义于头文件 <inttypes.h> (尽管 PRIdMAX 、 PRIuMAX 等就是 内存写入转换指定符 %n 是安全漏洞的常见目标,这里格式字符串依赖用户输入,而有边界检查的 在每个转换指定符的行动后有一个序列点;这允许于同一变量多次存入 %n 的结果,并在同一此调用中打印出先前以 %n 存储的值。 若转换指定非法,则行为未定义。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
... | - | 指定要打印数据的参数。若任何默认参数提升后的参数不拥有对应转换说明符所期待的类型,或若参数数量少于 format 的要求,则行为未定义。若有多于 format 要求的参数,则求值并忽略多出的参数。
|
返回值
buffer
的字符数(不计空终止字符),或若输出错误或编码错误(对于字符串和字符转换说明符)发生则为负值。bufsz
则本应写入到 buffer
的字符数(不计空终止字符),或若出现输出错误或编码错误(对于字符串和字符转换说明符)则为负值。buffer
的字符数,不计空终止字符(只要 buffer
不是空指针且 bufsz
非零且不大于 RSIZE_MAX
,就写入它),在运行时制约违规时为零,而在编码错误时为负值。bufsz
则本应写入 buffer
的字符数的,不包含空终止字符(只要 buffer
不是空指针而 bufsz
非零且不大于 RSIZE_MAX
,就写入它),或若出现输出错误、运行时制约违规错误或编码错误则为负值。注解
C 标准及POSIX 指定 sprintf
及其变体的行为在参数与目标缓冲区重叠时未定义。示例:
sprintf(dst, "%s and %s", dst, t); // <- 有错:未定义行为
POSIX 规定在错误时设置 errno 。它亦指定额外的转换指定,最值得注意的是对参数重排序的支持(紧随 % 后的 n$ 指示第 n
个参数)。
以零为 bufsz
和空指针为 buffer
调用 snprintf
可用于决定包含输出的缓冲区大小:
同 snprintf
,但不同于 sprintf_s
, snprintf_s
会将输出截断在 bufsz-1
之内。
示例
#include <stdio.h> int main(void) { printf("Strings:\n"); const char* s = "Hello"; printf("\t.%10s.\n\t.%-10s.\n\t.%*s.\n", s, s, 10, s); printf("Characters:\t%c %%\n", 65); printf("Integers\n"); printf("Decimal:\t%i %d %.6i %i %.0i %+i %u\n", 1, 2, 3, 0, 0, 4, -1); printf("Hexadecimal:\t%x %x %X %#x\n", 5, 10, 10, 6); printf("Octal:\t%o %#o %#o\n", 10, 10, 4); printf("Floating point\n"); printf("Rounding:\t%f %.0f %.32f\n", 1.5, 1.5, 1.3); printf("Padding:\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5); printf("Scientific:\t%E %e\n", 1.5, 1.5); printf("Hexadecimal:\t%a %A\n", 1.5, 1.5); }
输出:
Strings: . Hello. .Hello . . Hello. Characters: A % Integers Decimal: 1 2 000003 0 +4 4294967295 Hexadecimal: 5 a A 0x6 Octal: 12 012 04 Floating point Rounding: 1.500000 2 1.30000000000000004440892098500626 Padding: 01.50 1.50 1.50 Scientific: 1.500000E+00 1.500000e+00 Hexadecimal: 0x1.8p+0 0X1.8P+0
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.21.6.1 The fprintf function (p: 309-316)
- 7.21.6.3 The printf function (p: 324)
- 7.21.6.5 The snprintf function (p: 325)
- 7.21.6.6 The sprintf function (p: 325-326)
- K.3.5.3.1 The fprintf_s function (p: 591)
- K.3.5.3.3 The printf_s function (p: 593-594)
- K.3.5.3.5 The snprintf_s function (p: 594-595)
- K.3.5.3.6 The sprintf_s function (p: 595-596)
- C99 standard (ISO/IEC 9899:1999):
- 7.19.6.1 The fprintf function (p: 274-282)
- 7.19.6.3 The printf function (p: 290)
- 7.19.6.5 The snprintf function (p: 290-291)
- 7.19.6.6 The sprintf function (p: 291)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.9.6.1 The fprintf function
- 4.9.6.3 The printf function
- 4.9.6.5 The sprintf function
参阅
(C95)(C95)(C95)(C11)(C11)(C11)(C11) |
打印格式化宽字符输出到 stdout 、文件流或缓冲区 (函数) |
(C99)(C11)(C11)(C11)(C11) |
打印格式化输出到stdout、文件流或缓冲区 使用可变参数列表 (函数) |
将一个字符串写入文件流 (函数) | |
(C11)(C11)(C11) |
从stdin、文件流或缓冲区读取格式化输入 (函数) |