# C 庫函數 - fprintf() ## 描述 C 庫函數 **int fprintf(FILE *stream, const char *format, ...)** 發送格式化輸出到流 stream 中。 ## 聲明 下面是 fprintf() 函數的聲明。 ``` int fprintf(FILE *stream, const char *format, ...) ``` ## 參數 * **stream** -- 這是指向 FILE 對象的指針，該 FILE 對象標識了流。 * **format** -- 這是 C 字符串，包含了要被寫入到流 stream 中的文本。它可以包含嵌入的 format 標簽，format 標簽可被隨后的附加參數中指定的值替換，并按需求進行格式化。format 標簽屬性是 **%[flags][width][.precision][length]specifier**，具體講解如下： | specifier（說明符） | 輸出 | | --- | --- | | c | 字符 | | d 或 i | 有符號十進制整數 | | e | 使用 e 字符的科學科學記數法（尾數和指數） | | E | 使用 E 字符的科學科學記數法（尾數和指數） | | f | 十進制浮點數 | | g | 自動選擇 %e 或 %f 中合適的表示法 | | G | 自動選擇 %E 或 %f 中合適的表示法 | | o | 有符號八進制 | | s | 字符的字符串 | | u | 無符號十進制整數 | | x | 無符號十六進制整數 | | X | 無符號十六進制整數（大寫字母） | | p | 指針地址 | | n | 無輸出 | | % | 字符 | | flags（標識） | 描述 | | --- | --- | | - | 在給定的字段寬度內左對齊，默認是右對齊（參見 width 子說明符）。 | | + | 強制在結果之前顯示加號或減號（+ 或 -），即正數前面會顯示 + 號。默認情況下，只有負數前面會顯示一個 - 號。 | | (space) | 如果沒有寫入任何符號，則在該值前面插入一個空格。 | | # | 與 o、x 或 X 說明符一起使用時，非零值前面會分別顯示 0、0x 或 0X。 與 e、E 和 f 一起使用時，會強制輸出包含一個小數點，即使后邊沒有數字時也會顯示小數點。默認情況下，如果后邊沒有數字時候，不會顯示顯示小數點。 與 g 或 G 一起使用時，結果與使用 e 或 E 時相同，但是尾部的零不會被移除。 | | 0 | 在指定填充 padding 的數字左邊放置零（0），而不是空格（參見 width 子說明符）。 | | width（寬度） | 描述 | | --- | --- | | (number) | 要輸出的字符的最小數目。如果輸出的值短于該數，結果會用空格填充。如果輸出的值長于該數，結果不會被截斷。 | | * | 寬度在 format 字符串中未指定，但是會作為附加整數值參數放置于要被格式化的參數之前。 | | .precision（精度） | 描述 | | --- | --- | | .number | 對于整數說明符（d、i、o、u、x、X）：precision 指定了要寫入的數字的最小位數。如果寫入的值短于該數，結果會用前導零來填充。如果寫入的值長于該數，結果不會被截斷。精度為 0 意味著不寫入任何字符。 對于 e、E 和 f 說明符：要在小數點后輸出的小數位數。 對于 g 和 G 說明符：要輸出的最大有效位數。 對于 s: 要輸出的最大字符數。默認情況下，所有字符都會被輸出，直到遇到末尾的空字符。 對于 c 類型：沒有任何影響。 當未指定任何精度時，默認為 1。如果指定時不帶有一個顯式值，則假定為 0。 | | .* | 精度在 format 字符串中未指定，但是會作為附加整數值參數放置于要被格式化的參數之前。 | | length（長度） | 描述 | | --- | --- | | h | 參數被解釋為短整型或無符號短整型（僅適用于整數說明符：i、d、o、u、x 和 X）。 | | l | 參數被解釋為長整型或無符號長整型，適用于整數說明符（i、d、o、u、x 和 X）及說明符 c（表示一個寬字符）和 s（表示寬字符字符串）。 | | L | 參數被解釋為長雙精度型（僅適用于浮點數說明符：e、E、f、g 和 G）。 | * **附加參數** -- 根據不同的 format 字符串，函數可能需要一系列的附加參數，每個參數包含了一個要被插入的值，替換了 format 參數中指定的每個 % 標簽。參數的個數應與 % 標簽的個數相同。 ## 返回值 如果成功，則返回寫入的字符總數，否則返回一個負數。 ## 實例 下面的實例演示了 fprintf() 函數的用法。 ``` #include <stdio.h> #include <stdlib.h> int main() { FILE * fp; fp = fopen ("file.txt", "w+"); fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014); fclose(fp); return(0); } ``` 讓我們編譯并運行上面的程序，這將創建文件 **file.txt**，它的內容如下： ``` We are in 2014 ``` 現在讓我們使用下面的程序查看上面文件的內容： ``` #include <stdio.h> int main () { FILE *fp; int c; fp = fopen("file.txt","r"); while(1) { c = fgetc(fp); if( feof(fp) ) { break ; } printf("%c", c); } fclose(fp); return(0); } ```