命名空间
变体
操作

std::stof, std::stod, std::stold

来自 cppreference.cn
< cpp‎ | string‎ | basic string
 
 
 
std::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 确定)(定义尾数)
  • (可选) eE,后跟可选的减号或加号以及非空十进制数字序列(定义以 10 为底的指数)
  • 十六进制浮点数表达式。它由以下部分组成:
  • (可选) 加号或减号
  • 0x0X
  • 非空十六进制数字序列,可选择包含小数点字符(由当前的 C locale 确定)(定义尾数)
  • (可选) pP,后跟可选的减号或加号以及非空十进制数字序列(定义以 2 为底的指数)
  • 无穷大表达式。它由以下部分组成:
  • (可选) 加号或减号
  • INFINFINITY,忽略大小写
  • 非数值表达式。它由以下部分组成:
  • (可选) 加号或减号
  • NANNAN(char_sequence),忽略 NAN 部分的大小写。char_sequence 只能包含数字、拉丁字母和下划线。结果是一个安静的 NaN 浮点数值。
  • 任何其他可能被当前安装的 C locale 接受的表达式。

如果 pos 不是空指针,则 ptr 将接收 str.c_str() 中第一个未转换字符的地址,并且将计算该字符的索引并存储在 *pos 中,从而给出转换处理的字符数。

目录

[编辑] 参数

str - 要转换的字符串
pos - 用于存储已处理字符数的整数地址

[编辑] 返回值

转换为指定浮点类型的字符串。

[编辑] 异常

std::invalid_argument 如果无法执行转换。

std::out_of_range 如果转换后的值超出结果类型的范围,或者如果底层函数(std::strtofstd::strtodstd::strtold)将 errno 设置为 ERANGE

[编辑] 示例

[编辑] 缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

DR 应用于 已发布行为 正确行为
LWG 2009 C++11 std::out_of_range 如果转换后的
值超出结果类型的范围,则不会抛出
将会抛出
LWG 2403 C++11 stof 调用了 std::strtodstd::wcstod stof 调用 std::strtofstd::wcstof

[编辑] 参见

(C++11)(C++11)(C++11)
将字符串转换为有符号整数
(函数) [编辑]
(C++11)(C++11)
将字符串转换为无符号整数
(函数) [编辑]
将字符序列转换为整数或浮点数值
(函数) [编辑]