std::stof, std::stod, std::stold
来自cppreference.com
< cpp | string | basic string
| 定义于头文件 <string>
|
||
| float stof( const std::string& str, std::size_t* pos = 0 ); float stof( const std::wstring& str, std::size_t* pos = 0 ); |
(1) | (C++11 起) |
| double stod( const std::string& str, std::size_t* pos = 0 ); double stod( const std::wstring& str, std::size_t* pos = 0 ); |
(2) | (C++11 起) |
| long double stold( const std::string& str, std::size_t* pos = 0 ); long double stold( const std::wstring& str, std::size_t* pos = 0 ); |
(3) | (C++11 起) |
转译 string str 中的浮点值。
函数会舍弃任何空白符（由 std::isspace() 确定），直至找到首个非空白符。然后它会取用尽可能多的字符，以构成合法的浮点数表示，并将它们转换成浮点值。合法的浮点值可以为下列之一：
- 十进制浮点数表达式。它由下列部分组成：
- (可选) 正或负号
- 非空的十进制数字序列，可选地包含一个小数点字符（由当前的 C 本地环境确定）（定义有效数字）
- (可选)
e或E，并跟随可选的正或负号，以及非空十进制数字序列（以 10 为底定义指数）
- 二进制浮点数表达式。它由下列部分组成：
- (可选) 正或负号
-
0x或0X - 非空的十六进制数字序列，选地包含一个小数点字符（由当前的 C 本地环境确定）（定义有效数字）
- (可选)
p或P，并跟随可选的正或负号，以及非空十进制数字序列（以 2 为底定义指数）
- 无穷大表达式。它由下列部分组成：
- (可选) 正或负号
-
INF或INFINITY，忽略大小写
- 非数（NaN）表达式。它由下列部分组成：
- (可选) 正或负号
-
NAN或NAN(char_sequence)，忽略NAN部分的大小写。 char_sequence 只能由数字、拉丁字母和下划线构成。结果是一个安静的 NaN 浮点值。
- 任何其他可由当前 C 本地环境接受的表达式
若 pos 不是空指针，则对于转换函数为内部的指针 ptr 将接受 str.c_str() 中首个未转换字符的地址，然后计算该字符的下标并存储之于 *pos ，给出转换处理的字符数。
参数
| str | - | 要转换的 string |
| pos | - | 存储已处理字符数的整数的地址 |
返回值
转换为指定浮点类型的字符串。
异常
若不能进行转换则为 std::invalid_argument 。
若转换后的值会落在结果类型的范围外，或若底层函数（ strtof 、 strtod 或 strtold ）设置 errno 为 ERANGE 则为 std::out_of_range 。
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| DR | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 2403 | C++11 | stof 调用 std::strtod 或 std::wcstod
|
stof 调用 std::strtof 或 std::wcstof
|
参阅
| (C++11)(C++11)(C++11) |
转换字符串为有符号整数 (函数) |
| (C++11)(C++11) |
转换字符串为无符号整数 (函数) |
| (C++17) |
转换字符序列到整数或浮点值 (函数) |
