std::vwscanf、std::vfwscanf、std::vswscanf

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

C 风格 I/O

类型和对象
FILE fpos_t	stdinstdoutstderr
函数
文件访问 fopen freopen fclose fflush fwide setbuf setvbuf 直接输入/输出 fread fwrite 非格式化输入/输出 fgetcgetc fgets fputcputc fputs getchar gets (直到 C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 格式化输入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	格式化输出 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 文件定位 ftell fgetpos fseek fsetpos rewind 错误处理 clearerr feof ferror perror 文件操作 remove rename tmpfile tmpnam

 

定义在头文件 <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 字符串包含

• 非空白宽字符，除了 %：格式字符串中的每个此类字符都会从输入流中消耗一个完全相同的字符，或者如果流上的下一个字符不等于它，则导致函数失败。
• 空白字符：格式字符串中的任何单个空白字符都会消耗来自输入的所有可用的连续空白字符（确定方式与在循环中调用 iswspace 相同）。请注意，"\n"、" "、"\t\t" 或格式字符串中的其他空白字符之间没有区别。
• 转换说明符。每个转换说明符都具有以下格式

• 介绍性 % 字符。

• (可选) 赋值抑制字符 *。如果存在此选项，则函数不会将转换结果分配给任何接收参数。

• (可选) 整数（大于零），指定最大字段宽度，即函数在执行当前转换说明符指定的转换时允许消耗的最大字符数。请注意，%s 和 %[ 如果未提供宽度，则可能会导致缓冲区溢出。

• (可选)长度修饰符，指定接收参数的大小，即实际的目标类型。这会影响转换精度和溢出规则。默认目标类型因转换类型而异（参见下表）。

• 转换格式说明符。

以下是可用的格式说明符

转换 说明符	说明	参数类型
长度修饰符 →		hh (C++11)	h	(无)	l	ll (C++11)	j (C++11)	z (C++11)	t (C++11)	L
%	匹配字面量 %。	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A
c	匹配一个字符或字符序列。 如果使用宽度说明符，则匹配恰好宽度个宽字符（参数必须是指向具有足够空间的数组的指针）。与 %s 和 %[ 不同，它不会在数组末尾追加空字符。	N/A	N/A	char*	wchar_t*	N/A	N/A	N/A	N/A	N/A
s	匹配非空白字符序列（一个字符串）。 如果使用宽度说明符，则匹配最多宽度个字符或直到第一个空白字符出现，以先出现者为准。始终存储一个空字符，除了匹配的字符之外（因此参数数组必须至少有宽度+1 个字符的空间）
[set]	匹配来自 set 中字符的非空字符序列。 如果集合的第一个字符是 ^，则匹配集合中不存在的所有字符。如果集合以 ] 或 ^] 开头，则 ] 字符也包含在集合中。是否在扫描集中非初始位置使用字符 - 来指示范围，如 [0-9] 中那样，是实现定义的。如果使用宽度说明符，则仅匹配最多宽度个字符。始终存储一个空字符，除了匹配的字符之外（因此参数数组必须至少有宽度+1 个字符的空间）
d	匹配一个十进制整数。 数字的格式与 wcstol 预期的一样，base 参数的值为 10	signed char* 或 unsigned char*	signed short* 或 unsigned short*	signed int* 或 unsigned int*	signed long* 或 unsigned long*	signed long long* 或 unsigned long long*	intmax_t* 或 uintmax_t*	size_t*	ptrdiff_t*	N/A
i	匹配一个整数。 数字格式与 wcstol 中 base 参数为 0 时所期望的格式相同（基数由解析的第一个字符决定）。
u	匹配一个无符号十进制整数。 数字格式与 wcstoul 中 base 参数为 10 时所期望的格式相同。
o	匹配一个无符号八进制整数。 数字格式与 wcstoul 中 base 参数为 8 时所期望的格式相同。
x, X	匹配一个无符号十六进制整数。 数字格式与 wcstoul 中 base 参数为 16 时所期望的格式相同。
n	返回迄今为止读取的字符数。 不消耗任何输入。不增加赋值计数。如果指定符定义了抑制赋值的操作符，则行为未定义。
a, A(C++11) e, E f, F g, G	匹配一个浮点数。 数字格式与 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 之外的所有转换说明符在尝试解析输入之前都会消耗和丢弃所有前导空白字符（确定方法与调用 iswspace 相同）。这些消耗的字符不计入指定的最大字段宽度。

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

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

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

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

解析一个不完整的浮点数，其结尾是指数且没有数字，例如用转换说明符 "100er" 解析 %f，序列 "100e"（可能有效的浮点数的最长前缀）被消耗，导致匹配错误（消耗的序列无法转换为浮点数），剩下的部分为 "r"。一些现有的实现没有遵循这条规则，而是回退到只消耗 "100"，剩下的部分为 "er"，例如glibc 错误 1765。

返回值

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

另请参阅

wscanffwscanfswscanf	从 stdin、文件流或缓冲区中读取格式化的宽字符输入。 (函数)
C 文档 for vwscanf, vfwscanf, vswscanf