c文件输出函数printf, fprintf, sprintf, snprintf, printf

c文件输出函数printf, fprintf, sprintf, snprintf, printf

转自：

从给定位置加载数据，转换为字符串等价物，并写结果到各种池。

1) 写结果到 stdout 。

2) 写结果到文件流 stream 。

3) 写结果到字符串 buffer 。

4) 写结果到字符串 buffer 。至多写 buf_size - 1 个字符。产生的字符串会以空字符终止，除非 buf_size 为零。若 buf_size 为零，则不写入任何内容，且 buffer 可以是空指针，然而依旧计算返回值（会写入的字符数，不包含空终止符）并返回。

5-8) 同 (1-4) ，除了在运行时检测下列错误，并调用当前安装的制约处理函数：

• 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 才保证可用。

参数

返回值

1,2) 传输到输出流的字符数，或若出现输出错误或编码错误（对于字符串和字符转换指定符）则为负值。

3) 写入到 buffer 的字符数（不计空终止字符），或若输出错误或编码错误（对于字符串和字符转换指定符）发生则为负值。

4) 假如忽略 bufsz 则本应写入到 buffer 的字符数（不计空终止字符），或若出现输出错误或编码错误（对于字符串和字符转换指定符）则为负值。

5,6) 传输到输出流的字符数，或若出现输出错误、运行时制约违规错误或编码错误则为负值。

7) 写入到buffer的字符数，不计空终止字符（只要 buffer 不是空指针且 bufsz 非零且不大于 RSIZE_MAX ，就写入它），在运行时制约违规时为零，而在编码错误时为负值。

8) 假如忽略 bufsz 则本应写入 buffer 的字符数的，不包含空终止字符（只要 buffer 不是空指针而 bufsz 非零且不大于 RSIZE_MAX ，就写入它），或若出现输出错误、运行时制约违规错误或编码错误则为负值。

注意

C 标准及POSIX 指定 sprintf 及其变体的行为在参数与目标缓冲区重叠时未定义。示例：

sprintf(dst, "%s and %s", dst, t); // <- 有错：未定义行为

POSIX指定在错误时设置errno。它亦指定附加的转换指定，最值得注意的是对参数重排序的支持（紧随%之后的n$指示第n个参数）。

以零为 bufsz 和空指针为 buffer 调用 snprintf 可用于决定包含输出的缓冲区大小：

const char *fmt = "sqrt(2) = %f";
int sz = snprintf(NULL, 0, fmt, sqrt(2));
char buf[sz + 1]; // 注意为终止空字符 +1
snprintf(buf, sizeof buf, fmt, sqrt(2));

同 snprintf ，但不同于 sprintf_s ， snprintf_s 会将输出截断在 bufsz-1 之内。

示例

运行此代码

#include <stdio.h>int main(void)
{printf("Strings:n");const char* s = "Hello";printf("t.%10s.nt.%-10s.nt.%*s.n", s, s, 10, s);printf("Characters:t%c %%n", 65);printf("Integersn");printf("Decimal:t%i %d %.6i %i %.0i %+i %un", 1, 2, 3, 0, 0, 4, -1);printf("Hexadecimal:t%x %x %X %#xn", 5, 10, 10, 6);printf("Octal:t%o %#o %#on", 10, 10, 4);printf("Floating pointn");printf("Rounding:t%f %.0f %.32fn", 1.5, 1.5, 1.3);printf("Padding:t%05.2f %.2f %5.2fn", 1.5, 1.5, 1.5);printf("Scientific:t%E %en", 1.5, 1.5);printf("Hexadecimal:t%a %An", 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

参阅