std::stof, std::stod, std::stold
来自 cppreference.cn
< cpp | string | basic string
定义于头文件 <string> |
||
float stof ( const std::string& str, std::size_t* pos = nullptr ); |
(1) | (since C++11) |
float stof ( const std::wstring& str, std::size_t* pos = nullptr ); |
(2) | (since C++11) |
double stod ( const std::string& str, std::size_t* pos = nullptr ); |
(3) | (since C++11) |
double stod ( const std::wstring& str, std::size_t* pos = nullptr ); |
(4) | (since C++11) |
long double stold( const std::string& str, std::size_t* pos = nullptr ); |
(5) | (since C++11) |
long double stold( const std::wstring& str, std::size_t* pos = nullptr ); |
(6) | (since C++11) |
将字符串 str 中的浮点数值解析出来。
设 ptr 为类型 char* (1,3,5) 或 wchar_t* (2,4,6) 的内部指针(对于转换函数而言)。
1) 调用 std::strtof(str.c_str(), &ptr)。
2) 调用 std::wcstof(str.c_str(), &ptr)。
3) 调用 std::strtod(str.c_str(), &ptr)。
4) 调用 std::wcstod(str.c_str(), &ptr)。
5) 调用 std::strtold(str.c_str(), &ptr)。
6) 调用 std::wcstold(str.c_str(), &ptr)。
函数会丢弃任何空白字符(由 std::isspace 确定),直到找到第一个非空白字符。然后它会尽可能多地获取字符以形成有效的浮点数表示,并将它们转换为浮点数值。有效的浮点数值可以是以下之一:
- 十进制浮点数表达式。它由以下部分组成:
- (可选) 加号或减号
- 非空十进制数字序列,可选择包含小数点字符(由当前的 C locale 确定)(定义尾数)
- (可选)
e
或E
,后跟可选的减号或加号以及非空十进制数字序列(定义以 10 为底的指数)
- 十六进制浮点数表达式。它由以下部分组成:
- (可选) 加号或减号
-
0x
或0X
- 非空十六进制数字序列,可选择包含小数点字符(由当前的 C locale 确定)(定义尾数)
- (可选)
p
或P
,后跟可选的减号或加号以及非空十进制数字序列(定义以 2 为底的指数)
- 无穷大表达式。它由以下部分组成:
- (可选) 加号或减号
-
INF
或INFINITY
,忽略大小写
- 非数值表达式。它由以下部分组成:
- (可选) 加号或减号
-
NAN
或NAN(
char_sequence)
,忽略NAN
部分的大小写。char_sequence 只能包含数字、拉丁字母和下划线。结果是一个安静的 NaN 浮点数值。
- 任何其他可能被当前安装的 C locale 接受的表达式。
如果 pos 不是空指针,则 ptr 将接收 str.c_str() 中第一个未转换字符的地址,并且将计算该字符的索引并存储在 *pos 中,从而给出转换处理的字符数。
目录 |
[编辑] 参数
str | - | 要转换的字符串 |
pos | - | 用于存储已处理字符数的整数地址 |
[编辑] 返回值
转换为指定浮点类型的字符串。
[编辑] 异常
std::invalid_argument 如果无法执行转换。
std::out_of_range 如果转换后的值超出结果类型的范围,或者如果底层函数(std::strtof、std::strtod 或 std::strtold)将 errno 设置为 ERANGE。
[编辑] 示例
本节尚不完整 原因:没有示例 |
[编辑] 缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布行为 | 正确行为 |
---|---|---|---|
LWG 2009 | C++11 | std::out_of_range 如果转换后的 值超出结果类型的范围,则不会抛出 |
将会抛出 |
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) |
将字符序列转换为整数或浮点数值 (函数) |