命名空间
变体
操作

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

来自 cppreference.com
< cpp‎ | io‎ | c
 
C++
 
输入/输出库
 
C 风格 I/O
类型和对象
函数
文件访问
直接输入/输出
非格式化输入/输出
格式化输入
(C++11)(C++11)(C++11)    
wscanffwscanfswscanf
(C++11)(C++11)(C++11)    
 
定义在头文件 <cwchar> 中
int wscanf( const wchar_t* format, ... );
 (1)
int fwscanf( std::FILE* stream, const wchar_t* format, ... );
 (2)
int swscanf( const wchar_t* buffer, const wchar_t* format, ... );
 (3)

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

1) 从 stdin 读取数据。
2) 从文件流 stream 读取数据。
3) 从以 null 结尾的宽字符串 buffer 读取数据。

内容

[编辑] 参数

stream - 要从中读取的输入文件流
buffer - 指向要从中读取的以 null 结尾的宽字符串的指针
format - 指向一个以 null 结尾的宽字符串的指针，指定如何读取输入
... - 接收参数。


format 字符串由以下内容组成：

  • 非空白宽字符，除了 %：format 字符串中的每个此类字符都从输入流中消耗一个完全相同的字符，或者如果输入流上的下一个字符不匹配则导致函数失败。
  • 空白字符：format 字符串中的任何单个空白字符都将消耗输入流中所有可用的连续空白字符（确定方式与在循环中调用 iswspace 相同）。请注意，"\n"、" "、"\t\t" 或 format 字符串中的其他空白字符之间没有区别。
  • 转换说明符。每个转换说明符都具有以下格式
  • 介绍性 % 字符。
  • (可选) 赋值抑制字符 *。如果存在此选项，该函数不会将转换结果分配给任何接收参数。
  • (可选) 整数（大于零），指定最大字段宽度，即函数在执行当前转换说明符指定的转换时允许消耗的最大字符数。请注意，%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 和 %[ 不同，它不会将 null 字符追加到数组。

 N/A N/A
char*
wchar_t*
 N/A N/A N/A N/A N/A
s
匹配非空白字符序列（字符串）。

如果使用宽度说明符，则匹配最多宽度个字符或第一个空白字符，以先出现者为准。始终存储一个 null 字符，除了匹配的字符之外（因此参数数组必须至少有宽度+1 个字符的空间）

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

如果集合的第一个字符是 ^，则匹配集合中不存在的所有字符。如果集合以 ] 或 ^] 开头，则] 字符也被包含在集合中。对于扫描集中的非初始位置处的 - 字符是否可以指示一个范围（如 [0-9]）是实现定义的。如果使用宽度说明符，则只匹配最多宽度个字符。始终存储一个 null 字符，除了匹配的字符之外（因此参数数组必须至少有宽度+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 和 [ 始终在匹配的字符之外存储空终止符。目标数组的大小必须至少比指定的字段宽度大一。使用 %s 或 %[ 而不指定目标数组大小与 std::gets 一样不安全。

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

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

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

[edit] 返回值

成功读取的参数数量，如果在第一个接收参数被赋值之前发生错误，则返回 EOF。

[edit] 示例

本节尚未完善。
原因：没有示例。

[edit] 另请参见

(C++11)(C++11)(C++11)
 从 stdin、文件流
或使用可变参数列表的缓冲区中读取格式化的宽字符输入。
(函数) [edit]
C 文档 for wscanf, fwscanf, swscanf
Retrieved from "https://cppreference.cn/mwiki/index.php?title=cpp/io/c/fwscanf&oldid=125687"