std::from_chars

STD：来自[医]炭

Defined in header
std::from_chars_result from_chars(const char* first, const char* last, /see below/& value, int base = 10	(1)	(since C++17)
std::from_chars_result from_chars(const char* first, const char* last, float& value, std::chars_format fmt = std::chars_format::general	(2)	(since C++17)
std::from_chars_result from_chars(const char* first, const char* last, double& value, std::chars_format fmt = std::chars_format::general	(3)	(since C++17)
std::from_chars_result from_chars(const char* first, const char* last, long double& value, std::chars_format fmt = std::chars_format::general	(4)	(since C++17)
struct from_chars_result { const char* ptr; std::error_code ec; };	(5)	(since C++17)

分析字符序列[first,last)用于下面描述的模式。如果没有任何字符与模式匹配，或者解析匹配字符所获得的值在value，，，value，否则匹配模式的字符将被解释为算术值的文本表示形式，该值存储在value...

1%29整数解析器：期望模式与std::strtol在默认的%28“C”%29区域设置和给定的非零数字基中，除了基16不能识别“0x”或“0x”前缀外，只有减号才能识别%28，而不是加号%29，而且只对有符号的整数类型识别。value.范围内的数字10..35%28包括%29表示为小写字符a..z%28大写数字不能识别%29。库为所有有符号和无符号整数类型以及char作为参数的引用类型。value...

2-4%29个浮点分析器：期望模式与std::strtod在默认的%28“C”%29区域设置中，除了

加号不能识别%28，只允许减号%29。

如果fmt有std::chars_format::scientific定但不std::chars_format::fixed，则要求指数部分为%28，否则为可选的%29。

如果fmt有std::chars_format::fixed定但不std::chars_format::scientific，则不允许使用可选指数。

如果fmt是std::chars_format::hex，前缀“0x”或“0x”不允许%28字符串“0x123”解析为值“0”，其余数为“x 123”%29。

无论如何，结果值最多是两个浮点值中最接近与模式匹配的字符串的值之一。

5%29返回类型%28参见返回值低于%29

参数

first, last	-	valid character range to parse
value	-	the out-parameter where the parsed value is stored if successful
base	-	integer base to use: a value between 2 and 36 (inclusive).
fmt	-	floating-point formatting to use, a bitmask of type std::chars_format

返回值

在成功时，返回一个类型的值。from_chars_result使...ptr点的第一个字符不匹配模式，或其值等于last如果所有字符匹配ec是false当转换为bool...

如果没有模式匹配，则返回类型的值。from_chars_result使...ptr等号first和ec等号std::errc::invalid_argument...value是未经修改的。

如果模式匹配，但解析的值不在可由value，返回类型的值。from_chars_result使...ec等号std::errc::result_out_of_range和ptr指向第一个字符不匹配的模式。value是未经修改的。

例外

%280%29

注记

与C++和C库中的其他解析函数不同，std::from_chars是区域无关的，不分配的，不抛的。其他库%28使用的解析策略只有一小部分，例如std::sscanf提供%29。这是为了允许在常见的高吞吐量上下文(如基于文本的交换%28 JSON或XML%29)中使用最快的实现。

保证std::from_chars格式的浮点值都可以恢复。to_chars只有当两个函数来自同一个实现时，才会提供准确的。

例

另见

stoistolstoll (C++11)(C++11)(C++11)	converts a string to a signed integer (function)
stofstodstold (C++11)(C++11)(C++11)	converts a string to a floating point value (function)
strtolstrtoll	converts a byte string to an integer value (function)
strtofstrtodstrtold	converts a byte string to a floating point value (function)
scanffscanfsscanf	reads formatted input from stdin, a file stream or a buffer (function)
operator>>	extracts formatted data (public member function of std::basic_istream)

 © cppreference.com

在CreativeCommonsAttribution下授权-ShareAlike未移植许可v3.0。

http：//en.cppreference.com/w/cpp/实用程序/[医]炭