C++

参考

<cwchar> (wchar.h)

函数
<cwchar>

vwscanf

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

在内部，该函数从由 arg 标识的列表中检索参数，就像对其使用了 va_arg 一样，因此 arg 的状态很可能会因调用而改变。

无论如何，arg 应该在调用之前的某个时刻由 va_start 初始化，并且预计在调用之后的某个时刻由 va_end 释放。

宽字符在stdin是多字节字符：这些字符会像调用 mbrtowc 一样进行翻译（使用 stream 的内部 mbstate_t 对象）。

这是 vscanf （ <cstdio> ）的 宽字符 等效函数。

参数

format
C 语言宽字符串，包含一个格式字符串，其规范与 scanf 中的 format 相同（更多详情请参见 scanf）。
请注意，所有格式说明符的含义与 scanf 中的相同；因此，%lc应用于读取单个宽字符（而不是%c），同样%ls应用于宽字符串（而不是%s).
arg
一个标识由 va_start 初始化的可变参数列表的值。
va_list 是在 <cstdarg> 中定义的特殊类型。

返回值

成功时，函数返回成功填充的参数列表项的数量。由于匹配失败、读取错误或到达文件结尾，该计数可能与预期的项数相符，也可能更少（甚至为零）。

如果发生读取错误或在读取过程中到达 文件尾，则会设置相应的指示符（ feof 或 ferror ）。如果任何一个事件发生在成功读取任何数据之前，则返回 EOF 。

如果在解释宽字符时发生编码错误，函数会设置 errno 为EILSEQ.

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
/* 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


另见

vscanf
将格式化数据读入可变参数列表(函数)
wscanf
从 stdin 读取格式化数据(函数)
fscanf
从流中读取格式化数据(函数)
scanf
从 stdin 读取格式化数据(函数)