函式
<cstdio>

vfscanf

int vfscanf ( FILE * stream, const char * format, va_list arg );
從流中讀取格式化資料到可變引數列表
stream讀取資料,並根據引數format將其儲存到變數引數列表arg所指向的元素中。

在內部,該函式從由 arg 標識的列表中檢索引數,就像對其使用了 va_arg 一樣,因此 arg 的狀態很可能會因呼叫而改變。

無論如何,arg 應該在呼叫之前的某個時刻由 va_start 初始化,並且預計在呼叫之後的某個時刻由 va_end 釋放。

引數

stream
指向標識輸入流的 FILE 物件的指標。
format
C 字串,包含一個格式化字串,其遵循與 scanf 中的 format 相同的規範(詳見 scanf)。
arg
一個標識由 va_start 初始化的可變引數列表的值。
va_list 是在 <cstdarg> 中定義的特殊型別。

返回值

成功時,函式返回成功填充的引數列表項的數量。由於匹配失敗、讀取錯誤或到達檔案結尾,該計數可能與預期的項數相符,也可能更少(甚至為零)。

如果在讀取過程中發生讀取錯誤或到達檔案末尾,則會設定相應的指示符(feofferror)。如果這些情況在成功讀取任何資料之前發生,則返回 EOF

如果在解釋寬字元時發生編碼錯誤,函式會設定 errnoEILSEQ.

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
/* vfscanf example */
#include <stdio.h>
#include <stdarg.h>

void ReadStuff (FILE * stream, const char * format, ...)
{
  va_list args;
  va_start (args, format);
  vfscanf (stream, format, args);
  va_end (args);
}

int main ()
{
  FILE * pFile;
  int val;
  char str[100];

  pFile = fopen ("myfile.txt","r");

  if (pFile!=NULL) {
    ReadStuff ( pFile, " %s %d ", str, &val );
    printf ("I have read %s and %d", str, val);
    fclose (pFile);
  }

  return 0;
}

另見