C语言 vwscanf用法及代码示例

C语言wchar头文件(wchar.h)中vwscanf函数的用法及代码示例。

用法:

int vwscanf ( const wchar_t * format, va_list arg );

将格式化的数据读入变量参数列表

从标准输入读取数据(stdin)并根据C宽字符串存储它们格式进入由变量标识的变量参数列表中的元素所指向的位置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>。

返回值

成功时，该函数返回已成功填充的参数列表的项目数。由于匹配失败，读取错误或到达的范围，此计数可以与预期的项目数匹配或更少(甚至为零)。文件结束。

如果发生读取错误或文件结束读取时到达指示符，设置了正确的指示符(feof或者ferror)。而且，如果在成功读取任何数据之前发生了任何一种情况，EOF返回。

如果在解释宽字符时发生编码错误，则该函数会设置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

相关用法

注：本文由纯净天空筛选整理自C标准库大神的英文原创作品 C vwscanf function。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。