# C 庫函數 - fscanf() ## 描述 C 庫函數 **int fscanf(FILE *stream, const char *format, ...)** 從流 stream 讀取格式化輸入。 ## 聲明 下面是 fscanf() 函數的聲明。 ``` int fscanf(FILE *stream, const char *format, ...) ``` ## 參數 * **stream** -- 這是指向 FILE 對象的指針，該 FILE 對象標識了流。 * **format** -- 這是 C 字符串，包含了以下各項中的一個或多個：_空格字符、非空格字符_ 和 _format 說明符_。 format 說明符形式為 **[=%[*][width][modifiers]type=]**，具體講解如下： | 參數 | 描述 | | --- | --- | | * | 這是一個可選的星號，表示數據是從流 stream 中讀取的，但是可以被忽視，即它不存儲在對應的參數中。 | | width | 這指定了在當前讀取操作中讀取的最大字符數。 | | modifiers | 為對應的附加參數所指向的數據指定一個不同于整型（針對 d、i 和 n）、無符號整型（針對 o、u 和 x）或浮點型（針對 e、f 和 g）的大小： h ：短整型（針對 d、i 和 n），或無符號短整型（針對 o、u 和 x） l ：長整型（針對 d、i 和 n），或無符號長整型（針對 o、u 和 x），或雙精度型（針對 e、f 和 g） L ：長雙精度型（針對 e、f 和 g） | | type | 一個字符，指定了要被讀取的數據類型以及數據讀取方式。具體參見下一個表格。 | **fscanf 類型說明符：** | 類型 | 合格的輸入 | 參數的類型 | | --- | --- | --- | | c | 單個字符：讀取下一個字符。如果指定了一個不為 1 的寬度 width，函數會讀取 width 個字符，并通過參數傳遞，把它們存儲在數組中連續位置。在末尾不會追加空字符。 | char * | | d | 十進制整數：數字前面的 + 或 - 號是可選的。 | int * | | e,E,f,g,G | 浮點數：包含了一個小數點、一個可選的前置符號 + 或 -、一個可選的后置字符 e 或 E，以及一個十進制數字。兩個有效的實例 -732.103 和 7.12e4 | float * | | o | 八進制整數。 | int * | | s | 字符串。這將讀取連續字符，直到遇到一個空格字符（空格字符可以是空白、換行和制表符）。 | char * | | u | 無符號的十進制整數。 | unsigned int * | | x,X | 十六進制整數。 | int * | * **附加參數** -- 根據不同的 format 字符串，函數可能需要一系列的附加參數，每個參數包含了一個要被插入的值，替換了 format 參數中指定的每個 % 標簽。參數的個數應與 % 標簽的個數相同。 ## 返回值 如果成功，該函數返回成功匹配和賦值的個數。如果到達文件末尾或發生讀錯誤，則返回 EOF。 ## 實例 下面的實例演示了 fscanf() 函數的用法。 ``` #include <stdio.h> #include <stdlib.h> int main() { char str1[10], str2[10], str3[10]; int year; FILE * fp; fp = fopen ("file.txt", "w+"); fputs("We are in 2014", fp); rewind(fp); fscanf(fp, "%s %s %s %d", str1, str2, str3, &year); printf("Read String1 |%s|\n", str1 ); printf("Read String2 |%s|\n", str2 ); printf("Read String3 |%s|\n", str3 ); printf("Read Integer |%d|\n", year ); fclose(fp); return(0); } ``` 讓我們編譯并運行上面的程序，這將產生以下結果： ``` Read String1 |We| Read String2 |are| Read String3 |in| Read Integer |2014| ```