C 庫函數 - fscanf()

C 標準庫 - <stdio.h> C 標準庫 - <stdio.h>

描述

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.12e4float *
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|

C 標準庫 - <stdio.h> C 標準庫 - <stdio.h>