C stdio fprintf() 函数

定义和用法

fprintf() 函数将一个格式化的字符串写入文件。

fprintf() 函数定义在 <stdio.h> 头文件中。

格式字符串可以包含格式说明符，这些说明符描述了如何以及在何处表示传递给函数的附加参数。

格式说明符的形式为 %[flags][width][.precision][length]specifier。方括号 [ ] 中的组件是可选的。

flags（标志）：可选。以下字符的任意序列：

`-`	使输出左对齐，通过在右侧添加填充空格而不是左侧。
`#`	根据转换显示格式化数据的替代表示。
`+`	使正数总是以 "+" 为前缀。
（空格字符）	为正数添加空格前缀，主要是为了使数字与负数的数字对齐。
`0`	在左侧用零填充数字。

width（宽度）：可选。整数，指定输出应占用的最小字符数。如有必要，会在右侧添加空格以达到此数字，如果使用了 - 标志，则在左侧添加。如果使用 *，则宽度由被表示参数之前的参数给出。

.precision（精度）：可选。点号 . 后跟整数，指示在格式化数据中显示多少位小数。

length（长度）：可选。字符序列，更改参数的预期数据类型。可以是以下之一：

`hh`	期望 `char` 类型的整数。
`h`	期望 `short int` 类型的整数。
`l`	期望 `long int` 类型的整数。期望 `wint_t` 类型的字符。期望 `wchar_t*` 类型的字符串。
`ll`	期望 `long long int` 类型的整数。
`j`	期望 `intmax_t` 或 `uintmax_t` 类型的整数。
`z`	期望 `size_t` 类型的整数。
`t`	期望 `ptrdiff_t` 类型的整数。
`L`	期望 `long double` 类型的浮点数。

specifier（说明符）：必需。字符，指示应如何表示参数的数据。可能的字符列表如下表所示。

字符	说明符	描述
`d` 或 `i`	十进制整数	将整数表示为十进制整数。
`u`	无符号十进制整数	将整数表示为无符号十进制整数。
`o`	八进制整数	将整数表示为八进制整数。`#` 标志会在数字前加上 "`0`"。
`x` 或 `X`	十六进制整数	将整数表示为十六进制整数。`#` 标志会在数字前加上 "`0x`"。如果使用 "X"，则数字 `A` 到 `F` 和字母 `X` 以大写显示。
`f` 或 `F`	浮点数	表示浮点数。如果使用 "`F`"，则字母（如 "nan" 中的值）以大写表示。 `#` 标志会强制显示小数点，即使没有小数位。
`e` 或 `E`	科学计数法	以科学计数法表示浮点数。如果使用 "`E`"，则字母以大写表示。 `#` 标志会强制显示小数点，即使没有小数位。
`g` 或 `G`	通用数字	对浮点数使用 `f` 和 `e` 中最短的表示。如果使用 "`G`"，则在 `F` 和 `E` 之间选择。
`a` 或 `A`	十六进制浮点数	用十六进制数字写入浮点数的内部表示。如果使用 "`A`"，则数字以大写表示。
`c`	字符	表示一个字符。如果参数是整数，则表示由整数指定的 ASCII 值的字符。
`s`	字符串	表示一个字符串。
`p`	指针	表示指针的内存地址，通常用十六进制数字。
`n`	无输出	将到目前为止写入文件的字符数写入参数。参数必须是指向整数的指针。
`%`	百分号	表示字面量 "`%`" 字符。

在 printf() 函数参考页中可以找到如何使用格式说明符的各种实例。

写入文件：

FILE *fptr;

// 以写入模式打开文件
fptr = fopen("filename.txt", "w");

// 向文件写入一些文本
fprintf(fptr, "Some text");

// 关闭文件
fclose(fptr);

fprintf(FILE * fptr, const char * format, arg1, arg2...);

参数	描述
fptr	必需。文件指针，通常由 `fopen()` 函数创建。
format	必需。字符串，表示要写入文件的数据格式。
arg1, arg2...	可选。任意数量的附加参数，它们的值可以通过格式参数中的说明符进行格式化并写入文件。

返回：	`int` 值，表示写入文件的字符数。如果发生错误，则返回负数。