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

將字串寫入流 (函式)