strtof, strtod, strtold
来自 cppreference.cn
定义于头文件 <stdlib.h> |
||
float strtof ( const char* restrict str, char** restrict str_end ); |
(1) | (since C99) |
(2) | ||
double strtod ( const char* str, char** str_end ); |
(until C99) | |
double strtod ( const char* restrict str, char** restrict str_end ); |
(since C99) | |
long double strtold( const char* restrict str, char** restrict str_end ); |
(3) | (since C99) |
将字节字符串 str
指向的浮点数值进行解释。
函数会丢弃任何空白字符(由 isspace 确定),直到找到第一个非空白字符。然后,它会尽可能多地获取字符以形成有效的浮点数表示,并将其转换为浮点数值。
- 十进制浮点数表达式。它由以下部分组成:
- (可选)加号或减号
- 非空十进制数字序列,可选择包含小数点字符(由当前 C locale 确定)(定义有效数字)
- (可选)
e
或E
后跟可选的减号或加号以及非空十进制数字序列(定义以 10 为底的指数)
|
(since C99) |
- 任何其他可能被当前安装的 C locale 接受的表达式。
函数会将 str_end
指向的指针设置为指向最后一个被解释字符的下一个字符。如果 str_end
是空指针,则会被忽略。
目录 |
[编辑] 参数
str | - | 指向要解释的空字符结尾的字节字符串的指针 |
str_end | - | 指向字符指针的指针 |
[编辑] 返回值
成功时,返回与 str
内容对应的浮点数值。如果转换后的值超出相应返回类型的范围,则会发生范围错误(errno 设置为 ERANGE),并返回 HUGE_VAL、HUGE_VALF 或 HUGE_VALL。如果无法执行转换,则返回 0
。
[编辑] 示例
运行此代码
#include <errno.h> #include <stdio.h> #include <stdlib.h> int main(void) { // parsing with error handling const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6 1.18973e+4932zzz"; printf("Parsing '%s':\n", p); char* end = NULL; for (double f = strtod(p, &end); p != end; f = strtod(p, &end)) { printf("'%.*s' -> ", (int)(end - p), p); p = end; if (errno == ERANGE) { printf("range error, got "); errno = 0; } printf("%f\n", f); } // parsing without error handling printf("\" -0.0000000123junk\" --> %g\n", strtod(" -0.0000000123junk", NULL)); printf("\"junk\" --> %g\n", strtod("junk", NULL)); }
可能的输出
Parsing '111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6 1.18973e+4932zzz': '111.11' -> 111.110000 ' -2.22' -> -2.220000 ' Nan' -> nan ' nan(2)' -> nan ' inF' -> inf ' 0X1.BC70A3D70A3D7P+6' -> 111.110000 ' 1.18973e+4932' -> range error, got inf " -0.0000000123junk" --> -1.23e-08 "junk" --> 0
[编辑] 参考
- C23 标准 (ISO/IEC 9899:2024)
- 7.22.1.3 strtod、strtof 和 strtold 函数(页码:待定)
- C17 标准 (ISO/IEC 9899:2018)
- 7.22.1.3 strtod、strtof 和 strtold 函数(页码:249-251)
- C11 标准 (ISO/IEC 9899:2011)
- 7.22.1.3 strtod、strtof 和 strtold 函数(页码:342-344)
- C99 标准 (ISO/IEC 9899:1999)
- 7.20.1.3 strtod、strtof 和 strtold 函数(页码:308-310)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.10.1.4 strtod 函数
[编辑] 参见
将字节字符串转换为浮点数值 (函数) | |
(C99)(C95)(C99) |
将宽字符串转换为浮点数值 (函数) |
C++ 文档 for strtof, strtod, strtold
|