C++ swscanf()用法及代码示例

swscanf() 函数在<cwchar> 头文件中定义。

swscanf()原型

int swscanf( const wchar_t* buffer, const wchar_t* format, ... );

swscanf() 函数从缓冲区读取数据并将值存储到相应的变量中。

参数：

• buffer ：指向要从中读取数据的宽字符串缓冲区的指针。
• format: 指向指定如何读取输入的以空字符结尾的字符串的指针。它由以 % 开头的格式说明符组成。
  格式字符串包含以下部分：
  • 除 % 之外的非空白字符，每个字符都使用输入流中的一个相同字符。如果流中的下一个字符比较不相等，可能会导致函数失败。
  • 空白字符：所有连续的空白字符都被视为单个空白字符。此外，'\n'、'\t'和''被认为是相同的。
  • 转换规范：遵循以下格式：
    • 指定开头的初始 % 字符
    • 一个可选的 * 称为 assignment-suppressing 字符。如果此字符存在，swscanf() 不会将结果分配给任何接收参数。
    • 一个可选的正整数，指定最大字段宽度。它指定swscanf() 在进行当前转换规范指定的转换时允许使用的最大字符数。
    • 一个可选的长度修饰符，指定接收参数的大小。
    • 转换格式说明符。

  格式说明符

  格式说明符	说明
  %	匹配文字 %
  c	匹配单个字符或多个字符。如果定义了宽度，则完全匹配宽度字符。
  s	匹配连续的非空白字符。如果定义了宽度，则完全匹配宽度字符或直到找到第一个空格。
  [放]	匹配给定字符集中的非空字符序列。如果^出现在 set 的开头，则匹配所有不在 set 中的字符。
  d	匹配十进制整数。
  i	匹配一个整数。
  o	匹配一个无符号八进制整数。
  X 或 x	匹配无符号十六进制整数。
  u	匹配无符号十进制整数。
  A 或 a、E 或 e、F 或 f、G 或 g	匹配一个浮点数。
  n	返回到目前为止读取的字符数。
  p	匹配定义指针的实现定义的字符序列。

  
  所以格式说明符的一般格式是：

  %[*][width][length]specifier

• … ：用于接收数据的其他附加参数。它们根据格式说明符按顺序出现。

返回：

• swscanf() 函数返回成功分配的接收参数的数量。
• 如果在分配第一个接收参数之前发生故障，EOF被退回。

示例：swscanf() 函数如何工作？

#include <cwchar>
#include <clocale>

int main()
{
	wchar_t buffer[100] = L"Theta \u03b8";
	wchar_t symbol, desc[10];

	setlocale(LC_ALL, "en_US.UTF-8");
	swscanf(buffer, L"%ls %lc", desc, &symbol);
	
	wprintf(L"%lc is %ls\n", symbol, desc);
	return 0;
}

运行程序时，可能的输出将是：

θ is Theta