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