Home C&C++函数库 c++ 语法 程序源码 Linux C库

vwscanf

函数  <cwchar>

int vwscanf ( const wchar_t * format, va_list arg );
将格式化的数据读入变量参数列表
从标准输入(stdin)读取数据,并根据C宽字符串参数format将数据存储到arg的变量参数列表中的元素所指向的位置中。

在内部,函数从arg标识的列表中检索参数,就像在它上面使用了va_arg一样,因此arg的状态很可能会被调用改变。

在任何情况下,arg都应该在调用之前的某个点被va_start初始化, 并且它应该在调用之后的某个点被va_end释放。

stdin中宽字符的外部表示形式是多字节字符: 这些字符的编译就像调用了mbrtowc 一样(使用流的内部mbstate_t对象)。 这是相当于vscanf (<cstdio>)的宽字符版本。

☲  参数



format
C宽字符串,它包含一个格式字符串,该格式字符串遵循与scanf格式相同的规范 (详情请参阅scanf)。

请注意,所有格式说明符都与scanf中的含义相同; 因此,应使用%lc读取宽字符(而不是%c),应使用%ls读取宽字符串(而不是%s)。

arg
一个值,标识用va_start初始化的变量参数列表。
va_list 是<cstdarg>中定义的特殊类型。

☉  返回值



如果成功,函数将返回成功填充参数列表的项数。该计数可以匹配预期的项数, 或者由于匹配失败、读取错误或文件结束的范围而小于(甚至为零)。

如果发生读取错误或在读取时到达文件结束,则设置正确的指示符(feofferror)。 并且,如果任何一种情况发生在任何数据可以成功读取之前,则返回WEOF.

如果在解释宽字符时发生编码错误,该函数将errno设置为EILSEQ。

☣  示例



/* vwscanf example */
#include <stdio.h>
#include <stdarg.h>
#include <wchar.h>

void GetWideMatches ( const wchar_t * format, ... )
{
  va_list args;
  va_start (args, format);
  vwscanf (format, args);
  va_end (args);
}

int main ()
{
  int val;
  wchar_t str[100];

  wprintf (L"Please enter a number and a word: ");
  GetWideMatches (L"%d %l[aeiou]", &val, str);
  wprintf (L"Number read: %d\nFirst vowels read: %ls\n", val, str);

  return 0;
}

可能输出:
Please enter a number and a word: 112 outperforming
Number read: 112
First vowels read: ou


🍄  另请参阅



scanf 从stdin读取格式化的数据(function )
wscanf 从stdin读取格式化的数据(function )
vscanf 将格式化的数据读入变量参数列表(function )
fscanf 从流读取格式化的数据(function )

联系我们 免责声明 关于CandCplus 网站地图