std::vscanf, std::vfscanf, std::vsscanf

来自cppreference.com
< cpp‎ | io‎ | c

 
 
 
C-风格的I / O
功能
原文:
Functions
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
文件访问
原文:
File access
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
直接输入/输出
原文:
Direct input/output
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
未格式化的输入/输出
原文:
Unformatted input/output
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
格式化输入/输出
原文:
Formatted input/output
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
vscanfvfscanfvsscanf
(C++11)
(C++11)
(C++11)
文件定位
原文:
File positioning
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
错误处理
原文:
Error handling
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
对文件的操作
原文:
Operations on files
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
 
定义于头文件 <cstdio>
int vscanf( const char *format, va_list vlist );
(1) (C++11 起)
int vfscanf( FILE *stream, const char *format, va_list vlist );
(2) (C++11 起)
int vsscanf( const char *buffer, const char *format, va_list vlist );
(3) (C++11 起)
从各种来源中读取数据,解释它根据formatvlist所定义的位置,并将结果存储到.
原文:
Reads data from the a variety of sources, interprets it according to format and stores the results into locations defined by vlist.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
1)
读取的数据stdin.
原文:
Reads the data from stdin.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
2)
读取文件中的数据流stream.
原文:
Reads the data from file stream stream.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3)
读取的数据null结尾的字符串buffer.
原文:
Reads the data from null-terminated character string buffer.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 参数

stream -
输入文件流中读取
原文:
input file stream to read from
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
buffer -
指针指向一个空结束的字符串读取
原文:
pointer to a null-terminated character string to read from
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
format -
指针指向一个空结束的字符串指定如何读取输入。

格式字符串由下列内容组成

  • 非空白多字节字符,除了%:每个格式字符串中的这种字符处理来自输入流的准确同一字符,或若它与流的下个字符比较不相等则导致函数失败。
  • 空白符:任何格式字符串中的单格空白符处理所有来自输出的可用连续空白符(如同按在循环中调用isspace来确定)。注意在格式字符串中"\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的字符的非空字符序列。

若set的首个字符是^,则匹配所有不在集合中的字符。若set以]^]为始则]字符亦被包含入集合。在扫描集合的非最初位置的字符-是否可以指示范围,如[0-9],是实现定义的。若使用宽度指定符,则最多匹配到宽度。总是在匹配的字符后存储一个空字符(故参数数组必须有至少宽度+1个字符的空间)。

d
匹配一个十进制整数

该数的格式同strtol()以值10base时所期望者

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
匹配一个整数

该数的格式同strtol()以值0base时所期望者(基底以首个分析的字符确定)

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

该数的格式同strtoul()以值10base参数时所期望者。

o
匹配一个无符号八进制数

该数的格式同strtoul()以值8base参数时所期望者。

x, X
匹配一个无符号十六进制整数

该数的格式同strtoul()以值16base参数时所期望者。

n
返回迄今读取的字符数

不消耗输出。不增加赋值计数。若此指定符拥有赋值抑制运算符,则行为未定义。

a, A(C++11)
e, E
f, F
g, G
匹配一个浮点数

该数的格式同strtof()所期望者。

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的转换指定符,不超过任何指定域宽,且要么是准确为转换指定符所期待,要么是其所期待的前缀的最长输入字符序列,就是从流中被消耗的内容。首个字符若存在,则在此被消耗序列后保持未读取。若被消耗序列拥有零长度或被消耗序列不能转换成上面所指定的项目,则发生匹配失败,除非遇到文件尾、编码错误,或阻止从流输入的读取错误,在此情况下这是一个输入失败。

所有异于[cn的转换指定符,在尝试分析输入前消耗并舍弃所有前导空白字符(如同以调用isspace来确定)。这些被消耗的字符不计入指定的最大域宽。

转换指定符lclsl[进行多字节到宽字符转换,如同如同在转换首字符前,通过用初始化到零的mbstate_t对象调用mbrtowc()

转换指定符s[始终在匹配字符之后存出一个空字符。目标数组的大小必须至少比指定域宽大一。

定宽整数类型int8_t等)的正确的转换指定定义于头文件<cinttypes>(尽管SCNdMAXSCNuMAX等就是%jd%ju等的别名)。

在每个转换指定符后有一个序列点;这允许存储多个域到同一“池”变量中。

在分析以无数字指数为结尾的不完整浮点值,如以转换指定符%f分析"100er"时,消耗序列"100e"(可能为合法浮点数的最长前缀),并导致匹配错误(被消耗序列不能转换成浮点数),而留下"r"。既存实现不遵守此规则并回滚,以只消耗"100"而留下"er",例如glibc bug 1765

原文:
pointer to a null-terminated character string specifying how to read the input.

格式字符串由下列内容组成

  • 非空白多字节字符,除了%:每个格式字符串中的这种字符处理来自输入流的准确同一字符,或若它与流的下个字符比较不相等则导致函数失败。
  • 空白符:任何格式字符串中的单格空白符处理所有来自输出的可用连续空白符(如同按在循环中调用isspace来确定)。注意在格式字符串中"\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的字符的非空字符序列。

若set的首个字符是^,则匹配所有不在集合中的字符。若set以]^]为始则]字符亦被包含入集合。在扫描集合的非最初位置的字符-是否可以指示范围,如[0-9],是实现定义的。若使用宽度指定符,则最多匹配到宽度。总是在匹配的字符后存储一个空字符(故参数数组必须有至少宽度+1个字符的空间)。

d
匹配一个十进制整数

该数的格式同strtol()以值10base时所期望者

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
匹配一个整数

该数的格式同strtol()以值0base时所期望者(基底以首个分析的字符确定)

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

该数的格式同strtoul()以值10base参数时所期望者。

o
匹配一个无符号八进制数

该数的格式同strtoul()以值8base参数时所期望者。

x, X
匹配一个无符号十六进制整数

该数的格式同strtoul()以值16base参数时所期望者。

n
返回迄今读取的字符数

不消耗输出。不增加赋值计数。若此指定符拥有赋值抑制运算符,则行为未定义。

a, A(C++11)
e, E
f, F
g, G
匹配一个浮点数

该数的格式同strtof()所期望者。

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的转换指定符,不超过任何指定域宽,且要么是准确为转换指定符所期待,要么是其所期待的前缀的最长输入字符序列,就是从流中被消耗的内容。首个字符若存在,则在此被消耗序列后保持未读取。若被消耗序列拥有零长度或被消耗序列不能转换成上面所指定的项目,则发生匹配失败,除非遇到文件尾、编码错误,或阻止从流输入的读取错误,在此情况下这是一个输入失败。

所有异于[cn的转换指定符,在尝试分析输入前消耗并舍弃所有前导空白字符(如同以调用isspace来确定)。这些被消耗的字符不计入指定的最大域宽。

转换指定符lclsl[进行多字节到宽字符转换,如同如同在转换首字符前,通过用初始化到零的mbstate_t对象调用mbrtowc()

转换指定符s[始终在匹配字符之后存出一个空字符。目标数组的大小必须至少比指定域宽大一。

定宽整数类型int8_t等)的正确的转换指定定义于头文件<cinttypes>(尽管SCNdMAXSCNuMAX等就是%jd%ju等的别名)。

在每个转换指定符后有一个序列点;这允许存储多个域到同一“池”变量中。

在分析以无数字指数为结尾的不完整浮点值,如以转换指定符%f分析"100er"时,消耗序列"100e"(可能为合法浮点数的最长前缀),并导致匹配错误(被消耗序列不能转换成浮点数),而留下"r"。既存实现不遵守此规则并回滚,以只消耗"100"而留下"er",例如glibc bug 1765

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
vlist -
可变参数列表,其中包含接收的参数
原文:
variable argument list containing the receiving arguments
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 返回值

成功读取的参数个数,或EOF如果发生故障.
原文:
Number of arguments successfully read, or EOF if failure occurs.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 示例

[编辑] 另请参阅

stdin,文件流或缓冲区的读取格式的输入
原文:
reads formatted input from stdin, a file stream or a buffer
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数) [编辑]
打印格式化的输出stdout,一个文件流或buffer
使用可变参数列表
原文:
prints formatted output to stdout, a file stream or a buffer
using variable argument list
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数) [编辑]
vscanfvfscanfvsscanfC 文档