C stdio fprintf() 函数
示例
写入文件
FILE *fptr;
// 打开文件以写入模式
fptr = fopen("filename.txt", "w");
// 向文件写入一些文本
fprintf(fptr, "Some text");
// 关闭文件
fclose(fptr);
自己动手试一试 »
定义和用法
fprintf()
函数将格式化的字符串写入文件。
fprintf()
函数定义在 <stdio.h>
头文件中。
格式说明符
format 字符串可以包含 **格式说明符**,它们描述了如何在函数中表示传递给函数的其他参数。
格式说明符的形式为 %[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() 函数参考页。
语法
fprintf(FILE * fptr, const char * format, arg1, arg2...);
参数值
参数 | 描述 |
---|---|
fptr | 必需。一个文件指针,通常由 fopen() 函数创建。 |
format | 必需。一个字符串,表示要写入文件的数据的格式。 |
arg1, arg2... | 可选。任意数量的其他参数,它们的值可以通过 format 参数中的说明符进行格式化并写入文件。 |
技术详情
返回 | 一个 int 值,表示已写入文件的字符数。如果发生错误,则返回负数。 |
---|