std:: wscanf, std:: fwscanf, std:: swscanf

匹配一个 字符 或一系列 字符 。

• 如果使用宽度限定符，则精确匹配 width 个宽字符（参数必须指向具有足够空间的数组）。
• 与 %s 和 %[ 不同，不会向数组追加空字符。

匹配非空白字符序列（即 string ）。

• 若使用宽度限定符，则最多匹配 width 个字符或遇到首个空白字符即停止（以先到者为准）。
• 始终在匹配字符后存储空字符（因此参数数组必须至少有 width+1 个字符的空间）。

匹配来自字符 set 的非空字符序列。

• 若集合的首字符为 ^ ，则匹配所有不在该集合中的字符。
• 若集合以 ] 或 ^] 开头，则 ] 字符也会被包含在集合中。
• 在非起始位置出现的 - 字符是否表示范围（如 [0-9] ）由实现定义。
• 若使用了宽度限定符，则最多匹配 width 个字符。
• 始终在匹配的字符之外额外存储一个空字符（因此参数数组必须至少有 width+1 个字符的空间）。

匹配一个 十进制整数 。

• 数字格式与 std::wcstol 函数以 10 为 base 参数时所期望的格式相同。

匹配一个 整数 。

• 数字格式与 std::wcstol 所期望的格式相同，其中 ​ 0 ​ 作为 base 参数的值（进制由解析的首字符确定）。

匹配无符号 十进制整数 。

• 数字格式与 std::wcstoul 所期望的格式相同，其中 10 作为 base 参数的值。

匹配无符号 八进制整数 。

• 数字格式与 std::wcstoul 函数以 8 作为 base 参数时所期望的格式相同。

匹配无符号 十六进制整数 。

• 数字格式与 std::wcstoul 函数所期望的格式相同，其中 16 作为 base 参数的值。

返回 当前已读取的字符数 。

• 不消耗输入。不增加赋值计数。
• 若格式说明符定义了赋值抑制操作符，则行为未定义。

匹配 浮点数 。

• 数字格式与 std::wcstof 所预期的格式相同。

匹配实现定义的字符序列，用于表示 指针 。

• printf 系列函数应使用 %p 格式说明符生成相同序列。

对于除 n 之外的所有转换说明符，从流中消耗的是不超过任何指定字段宽度、且完全符合转换说明符预期或构成其预期序列前缀的最长输入字符序列。该消耗序列后的首个字符（若存在）将保持未读取状态。若消耗序列长度为零，或消耗序列无法按上述规则完成转换，则出现匹配失败——除非因文件结束、编码错误或读取错误导致无法从流中获取输入，此时属于输入失败。

除 [ 、 c 和 n 之外的所有转换说明符，在尝试解析输入前会消耗并丢弃所有前导空白字符（通过调用 std::iswspace 确定）。这些被消耗的字符不计入指定的最大字段宽度。

若未使用长度说明符 l ，则转换说明符 c 、 s 和 [ 会执行宽字符到多字节字符的转换，转换过程类似于在首个字符转换前调用 std::wcrtomb ，并初始化 std::mbstate_t 对象为零值。

转换说明符 s 和 [ 除了存储匹配的字符外，始终会额外存储空终止符。目标数组的大小必须至少比指定字段宽度大1。使用 % s 或 % [ 而不指定目标数组大小的行为，与 std::gets 同样不安全。

固定宽度整数类型 （如 std::int8_t 等）的正确转换规范定义于头文件 <cinttypes> 中（尽管 SCNdMAX 、 SCNuMAX 等分别等同于 % jd 、 % ju 等）。

每个转换说明符执行完成后存在一个 顺序点 ，这允许将多个字段存储至同一个“接收”变量中。

当解析以指数符号结尾但缺少数字的不完整浮点数值时（例如使用转换说明符 % f 解析 "100er" ），将消耗序列 "100e" （可能有效的浮点数的最长前缀），导致匹配错误（消耗的序列无法转换为浮点数），并保留 "r" 。某些现有实现未遵循此规则，会回退至仅消耗 "100" ，保留 "er" ，例如 glibc bug 1765 。

若转换规范无效，则行为未定义。