函数
<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;
}

另见