C++

参考

<cwchar> (wchar.h)

函数
<cwchar>

vswscanf

int vswscanf (const wchar_t* ws, const wchar_t* format, va_list arg);
从宽字符串读取格式化数据到可变参数列表
根据参数 format 中定义的格式，从 ws 读取数据，并存储到由可变参数列表 arg 指向的内存位置。

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

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

这是 vsscanf (<cstdio>) 的*宽字符*等价函数。

参数

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

返回值

成功时，函数返回成功填充的参数列表中的项目数。在匹配失败的情况下，此计数可以与预期的项目数相匹配，也可能更少（甚至为零）。
如果在任何数据可以被成功解析之前发生输入失败，则返回 EOF。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
/* vswscanf example */
#include <stdarg.h>
#include <wchar.h>

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

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

  GetWideMatches ( L"99 bottles of beer on the wall", L" %d %ls ", &val, buf);

  wprintf (L"Product: %ls\nQuantity: %d\n", buf, val);

  return 0;
}

可能的输出
Product: bottles
Quantity: 99


另见

wscanf
从 stdin 读取格式化数据(函数)
vfwscanf
从流中读取格式化数据到可变参数列表(函数)
swscanf
从字符串中读取格式化数据(函数)
scanf
从 stdin 读取格式化数据(函数)
vswprintf
将可变参数列表中的格式化数据写入到有大小限制的缓冲区(函数)