fprintf

参数

stream

指向一个 FILE 对象的指针，该对象标识一个输出流。

format

包含要写入流的文本的 C 字符串。
它可以选择性地包含嵌入的 格式说明符，这些说明符将被后续附加参数中指定的值替换并按要求格式化。

格式说明符 遵循以下原型

%[flags][width][.precision][length]specifier

其中末尾的 specifier 字符 是最重要的组成部分，因为它定义了其对应参数的类型和解释。

说明符	输出	示例
d 或 i	有符号十进制整数	392
u	无符号十进制整数	7235
o	无符号八进制	610
x	无符号十六进制整数	7fa
X	无符号十六进制整数 (大写)	7FA
f	十进制浮点数，小写	392.65
F	十进制浮点数，大写	392.65
e	科学计数法 (尾数/指数)，小写	3.9265e+2
E	科学计数法 (尾数/指数)，大写	3.9265E+2
g	使用最短的表示法%e或%f	392.65
G	使用最短的表示法%E或%F	392.65
a	十六进制浮点数，小写	-0xc.90fep-2
A	十六进制浮点数，大写	-0XC.90FEP-2
c	字符	a
s	字符串	sample
p	指针地址	b8000000
n	不打印任何内容。 相应的参数必须是指向signed int. 的指针。已写入的字符数存储在指向的位置。
%	A%后跟另一个%字符将写入一个单独的%到流中。	%

格式说明符 还可以包含子说明符：flags、width、.precision 和 modifiers (按此顺序)，它们是可选的，并遵循以下规范

标志	描述
-	在给定的字段宽度内左对齐；右对齐是默认值 (参见 width 子说明符)。
+	强制在结果前加上加号或减号 (+或-)，即使是正数也是如此。默认情况下，只有负数前面会带有-符号。
(space)	如果将要写入的符号不存在，则在值之前插入一个空格。
#	与o, x或X说明符一起使用时，对于非零值，结果前面会加上0, 0x或或 0X或 0X 分别。 与a, A, e, E, f, F, g或G它强制写入的输出包含小数点，即使后面没有更多的数字。默认情况下，如果没有数字跟随，则不写入小数点。
0	在指定填充时 (参见 width 子说明符)，用零 (0) 而不是空格左填充数字。

宽度	描述
(number)	要打印的最少字符数。如果待打印的值比此数字短，则结果会用空格填充。即使结果更长，值也不会被截断。
*	width 不在 format 字符串中指定，而是作为附加的整数值参数，放在需要格式化的参数之前。

.precision	描述
.数字	对于整数说明符 (d, i, o, u, x, X): precision 指定要写入的最少数字位数。如果待写入的值比此数字短，则结果会用前导零填充。即使结果更长，值也不会被截断。precision 为0表示该值不写入任何字符。0. 不写入任何字符。对于a, A, e, E, f和F说明符：这是小数点之后要打印的数字位数 (默认值为 6)。 不写入任何字符。对于g和G说明符：这是要打印的有效数字的最大位数。 不写入任何字符。对于s: 这是要打印的最大字符数。默认情况下，会一直打印所有字符，直到遇到结束的空字符为止。 如果指定了句点但未明确指定 precision 的值，则假定为00
.*	precision 不在 format 字符串中指定，而是作为附加的整数值参数，放在需要格式化的参数之前。

length 子说明符修改数据类型的长度。这是一个图表，显示了在有和没有 length 说明符时解释对应参数的类型 (如果使用了不同的类型，则执行适当的类型提升或转换，如果允许的话)。

	说明符
长度	d i	u o x X	f F e E g G a A	c	s	p	n
（无）	int	unsigned int	double	int	char*	void*	int*
hh	signed char	unsigned char					signed char*
h	short int	unsigned short int					short int*
l	long int	unsigned long int		wint_t	wchar_t*		long int*
ll	long long int	unsigned long long int					long long int*
j	intmax_t	uintmax_t					intmax_t*
z	size_t	size_t					size_t*
t	ptrdiff_t	ptrdiff_t					ptrdiff_t*
L			long double

注意，c说明符接受一个int(或 wint_t) 作为参数，但在格式化输出之前执行到char值 (或wchar_t) 的适当转换。

注意：黄色的行表示 C99 引入的说明符和子说明符。有关扩展类型的说明符，请参阅 <cinttypes>。

... （附加参数）

根据格式字符串，函数可能需要一系列附加参数，每个参数包含一个用于替换格式字符串中格式说明符的值（或者，对于n).
，是指向存储位置的指针）。这些参数的数量应至少与格式说明符中指定的值的数量一样多。额外的参数会被函数忽略。

返回值

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

/* fprintf example */
#include <stdio.h>

int main ()
{
   FILE * pFile;
   int n;
   char name [100];

   pFile = fopen ("myfile.txt","w");
   for (n=0 ; n<3 ; n++)
   {
     puts ("please, enter a name: ");
     gets (name);
     fprintf (pFile, "Name %d [%-10.10s]\n",n+1,name);
   }
   fclose (pFile);

   return 0;
}

Name 1 [John      ] 
Name 2 [Jean-Franc] 
Name 3 [Yoko      ]

兼容性

另见

printf

将格式化数据打印到 stdout (函数)

fscanf

从流中读取格式化数据(函数)

fwrite

将数据块写入流 (函数)

fputs

将字符串写入流 (函数)