int vscanf ( const char * format, va_list arg );
描述:
将格式化数据读入可变参数列表
从标准输入(stdin)读取数据,并根据参数格式将它们存储到由arg标识的变量参数列表中的元素指向的位置。
在内部,函数从arg标识的列表中检索参数,就好像va_arg被使用了一样,因此arg的状态很可能被调用所改变。
在任何情况下,arg都应该在调用之前的某个时刻由va_start初始化,并且在调用之后的某个时刻,预计会由va_end释放。
参数:
format
包含格式字符串的C字符串,其格式与scanf中的格式相同
arg
标识使用va_start初始化的变量参数列表的值。
va_list是在<cstdarg>中定义的特殊类型。
返回值:
成功时,函数返回成功填充的参数列表项数。 此计数可以匹配预期的项目数量,或者由于匹配失败,读取错误或文件结束的范围而减少(甚至为零)。
如果发生读取错误或在读取时达到文件结束,则设置正确的指示符(feof或ferror)。 而且,如果在任何数据可以被成功读取之前发生,则返回EOF。
如果发生编码错误解释宽字符,函数将errno设置为EILSEQ。
/* vscanf example */
#include <stdio.h>
#include <stdarg.h>
void GetMatches ( const char * format, ... )
{
va_list args;
va_start (args, format);
vscanf (format, args);
va_end (args);
}
int main ()
{
int val;
char str[100];
printf ("Please enter a number and a word: ");
fflush (stdout);
GetMatches (" %d %99s ", &val, str);
printf ("Number read: %d\nWord read: %s\n", val, str);
return 0;
}
输出:
Please enter a number and a word: 911 airport Number read: 911 Word read: airport