strtof, strtod, strtold
|
定义于头文件
<stdlib.h>
|
||
|
float
strtof
(
const
char
*
restrict
str,
char
**
restrict
str_end
)
;
|
(1) | (C99 起) |
| (2) | ||
|
double
strtod
(
const
char
*
str,
char
**
str_end
)
;
|
(C99 前) | |
|
double
strtod
(
const
char
*
restrict
str,
char
**
restrict
str_end
)
;
|
(C99 起) | |
|
long
double
strtold
(
const
char
*
restrict
str,
char
**
restrict
str_end
)
;
|
(3) | (C99 起) |
将 str 所指向的字节字符串中的浮点值进行解析。
函数会丢弃任何空白字符(由 isspace 判定)直至找到首个非空白字符。随后它会尽可能提取更多字符以构成有效的浮点数表示形式,并将其转换为浮点数值。有效的浮点数值可以是以下任意一种:
- 十进制浮点表达式。它由以下部分组成:
-
- (可选) 正号或负号
- 非空的十进制数字序列,可选地包含小数点字符(由当前C locale 确定)(定义有效数字)
-
(可选)
e或E后接可选的减号或加号以及非空的十进制数字序列(定义以 10 为底的指数)
|
(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) { // 带错误处理的解析 const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6 1.18973e+4932zzz"; printf("正在解析 '%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("范围错误,得到 "); errno = 0; } printf("%f\n", f); } // 无错误处理的解析 printf("\" -0.0000000123junk\" --> %g\n", strtod(" -0.0000000123junk", NULL)); printf("\"junk\" --> %g\n", strtod("junk", NULL)); }
可能的输出:
正在解析 '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' -> 范围错误,得到 inf " -0.0000000123junk" --> -1.23e-08 "junk" --> 0
参考文献
- C23 标准 (ISO/IEC 9899:2024):
-
- 7.22.1.3 strtod、strtof 和 strtold 函数 (p: 待定)
- C17 标准 (ISO/IEC 9899:2018):
-
- 7.22.1.3 strtod、strtof 和 strtold 函数 (p: 249-251)
- C11 标准 (ISO/IEC 9899:2011):
-
- 7.22.1.3 strtod、strtof 和 strtold 函数 (p: 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++ 文档
关于
strtof
,
strtod
,
strtold
|
|