命名空间
变体
操作

std::vwscanf, std::vfwscanf, std::vswscanf

来自 cppreference.cn
< cpp‎ | io‎ | c
 
C++
 
输入/输出库
 
C 风格 I/O
类型与对象
函数
文件访问
直接输入/输出
无格式输入/输出
格式化输入
(C++11)(C++11)(C++11)    
vwscanfvfwscanfvswscanf
(C++11)(C++11)(C++11)    
 
定义于头文件 <cwchar>
int vwscanf( const wchar_t* format, std::va_list vlist );
 (1) (自 C++11 起)
int vfwscanf( std::FILE* stream, const wchar_t* format, std::va_list vlist );
 (2) (自 C++11 起)
int vswscanf( const wchar_t* buffer, const wchar_t* format, std::va_list vlist );
 (3) (自 C++11 起)

从多种来源读取数据，根据 format 解释数据，并将结果存储到 vlist 定义的位置。

1) 从 stdin 读取数据。
2) 从文件流 stream 读取数据。
3) 从空终止宽字符串 buffer 读取数据。

目录

[编辑] 参数

stream - 从中读取的输入文件流
buffer - 指向从中读取的空终止宽字符串的指针
format - 指向指定如何读取输入的空终止宽字符串的指针
vlist - 包含接收参数的可变参数列表。


format 字符串由以下部分组成

  • 非空白宽字符，除了 %：格式字符串中的每个此类字符都从输入流中消耗一个完全相同的字符，或者如果流中的下一个字符不相等，则导致函数失败。
  • 空白字符：格式字符串中的任何单个空白字符都会消耗输入中所有可用的连续空白字符（通过在循环中调用 std::iswspace 确定）。 请注意，"\n"、" "、"\t\t" 或格式字符串中的其他空白之间没有区别。
  • 转换规范。 每个转换规范具有以下格式
  • 引导 % 字符。
  • (可选) 赋值抑制字符 *。 如果存在此选项，则函数不会将转换结果分配给任何接收参数。
  • (可选) 整数（大于零），指定最大字段宽度，即函数在执行当前转换规范指定的转换时允许消耗的最大字符数。 请注意，如果未提供宽度，则 %s 和 %[ 可能会导致缓冲区溢出。
  • (可选) 长度修饰符，用于指定接收参数的大小，即实际目标类型。 这会影响转换精度和溢出规则。 默认目标类型对于每种转换类型都不同（请参见下表）。
  • 转换格式说明符。

以下格式说明符可用

转换
说明符		 解释 预期
参数类型
长度修饰符→ hh h none l ll j z t L
仅自 C++11 起可用→ 是 是 是 是 是
%
匹配字面量 %。
 N/A N/A N/A N/A N/A N/A N/A N/A N/A
c

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

  • 如果使用宽度说明符，则完全匹配 width 个宽字符（参数必须是指向具有足够空间的数组的指针）。
  • 与 %s 和 %[ 不同，不会将空字符附加到数组。
 N/A N/A
char*
wchar_t*
 N/A N/A N/A N/A N/A
s

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

  • 如果使用宽度说明符，则最多匹配 width 个字符，或直到第一个空白字符，以先出现者为准。
  • 始终存储一个空字符，以及匹配的字符（因此参数数组必须有至少 width+1 个字符的空间）。
[set ]

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

  • 如果集合的第一个字符是 ^，则匹配集合中不存在的所有字符。
  • 如果集合以 ] 或 ^] 开头，则 ] 字符也包含在集合中。
  • 实现定义了扫描集非初始位置中的字符 - 是否可以指示范围，如 [0-9] 中所示。
  • 如果使用宽度说明符，则仅匹配最多 width 个字符。
  • 始终存储一个空字符，以及匹配的字符（因此参数数组必须有至少 width+1 个字符的空间）。
d

匹配一个 十进制整数。

  • 数字的格式与 std::wcstol 期望的格式相同，其中 10 作为 base 参数的值。
signed char* 或 unsigned char*
signed short* 或 unsigned short*
signed int* 或 unsigned int*
signed long* 或 unsigned long*
signed long long* 或 unsigned long long*
N/A
i

匹配一个 整数。

  • 数字的格式与 std::wcstol 期望的格式相同，其中 ​0​ 作为 base 参数的值（基数由解析的第一个字符确定）。
u

匹配一个无符号 十进制整数。

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

匹配一个无符号 八进制整数。

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

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

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

返回到目前为止读取的字符数。

  • 不消耗任何输入。 不会增加赋值计数。
  • 如果说明符定义了赋值抑制运算符，则行为未定义。
a (C++11)
A (C++11)
e
E
f
F (C++11)
g
G

匹配一个 浮点数。

  • 数字的格式与 std::wcstof 期望的格式相同。
 N/A N/A
float*
double*
 N/A N/A N/A N/A
long double*
p

匹配实现定义的字符序列，该序列定义一个 指针。

  • printf 函数族应使用 %p 格式说明符生成相同的序列。
 N/A N/A
void**
 N/A N/A N/A N/A N/A N/A
注解

对于除 n 以外的每个转换说明符，最长的输入字符序列（不超过任何指定的字段宽度，并且要么与转换说明符期望的完全相同，要么是它期望的序列的前缀）是从流中消耗的内容。 在此消耗序列之后的第一个字符（如果有）保持未读状态。 如果消耗的序列长度为零，或者如果消耗的序列无法按上述方式转换，则除非文件结尾、编码错误或读取错误阻止了从流中输入，否则会发生匹配失败，在这种情况下，这是输入失败。

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

如果未使用长度说明符 l，则转换说明符 c、s 和 [ 执行宽字符到多字节字符的转换，就像在第一个字符转换之前使用初始化为零的 std::mbstate_t 对象调用 std::wcrtomb 一样。

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

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

每个转换说明符的操作之后都有一个 序列点； 这允许在同一个“接收器”变量中存储多个字段。

当解析以指数结尾且没有数字的不完整浮点值时，例如使用转换说明符 %f 解析 "100er" 时，序列 "100e" （可能是有效浮点数的最长前缀）被消耗，导致匹配错误（消耗的序列无法转换为浮点数），并保留 "r"。 一些现有实现不遵循此规则，而是回滚为仅消耗 "100"，留下 "er"，例如 glibc 错误 1765。

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

[编辑] 返回值

成功读取的参数数量，如果发生故障，则为 EOF。

[编辑] 示例

本节不完整
原因：没有示例

[编辑] 参见

 从 stdin、文件流或缓冲区读取格式化的宽字符输入
(函数) [编辑]
C 文档 关于 vwscanf, vfwscanf, vswscanf
取自“https://cppreference.cn/mwiki/index.php?title=cpp/io/c/vfwscanf&oldid=157668”