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) |
转换字符序列到整数或浮点值 (函数) |