C語言 庫函數 fscanf()
C語言 庫函數 fscanf()
C 庫函數 int fscanf(FILE *stream, const char *format, ...) 從流 stream 讀取格式化輸入。
1. 聲明
下面是 fscanf() 函數的聲明。
int fscanf(FILE *stream, const char *format, ...)
2. 參數
- 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 參數中指定的每個 % 標簽。參數的個數應與 % 標簽的個數相同。
3. 返回值
如果成功,該函數返回成功匹配和賦值的個數。如果到達文件末尾或發生讀錯誤,則返回 EOF。
4. 實例
下面的實例演示了 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|