atof
From cppreference.net
|
定义于头文件
<stdlib.h>
|
||
|
double
atof
(
const
char
*
str
)
;
|
||
将 str 所指向的字节字符串中的浮点值进行解析。
函数会丢弃任何空白字符(由 isspace 判定)直至找到首个非空白字符。随后它会尽可能提取更多字符以构成有效的浮点数表示形式,并将其转换为浮点数值。有效的浮点数值可以是以下任意一种:
- 十进制浮点表达式。它由以下部分组成:
-
- (可选) 正号或负号
- 非空的十进制数字序列,可选地包含小数点字符(由当前C locale 确定)(定义有效数字)
-
(可选)
e或E后接可选的减号或加号以及非空的十进制数字序列(定义以 10 为底的指数)
|
(C99起) |
- 任何其他可能被当前安装的 C locale 接受的表达式。
目录 |
参数
| str | - | 指向要解析的以空字符结尾的字节字符串的指针 |
返回值
成功时返回与 str 内容对应的 double 值。若转换值超出返回类型的范围,则返回值未定义。若无法执行任何转换,则返回 0.0 。
注释
该名称代表“ASCII 转浮点数”。
示例
运行此代码
#include <stdio.h> #include <stdlib.h> int main(void) { printf("%g\n", atof(" -0.0000000123junk")); printf("%g\n", atof("0.012")); printf("%g\n", atof("15e16")); printf("%g\n", atof("-0x1afp-2")); printf("%g\n", atof("inF")); printf("%g\n", atof("Nan")); printf("%g\n", atof("1.0e+309")); // UB: 超出 double 类型范围 printf("%g\n", atof("0.0")); printf("%g\n", atof("junk")); // 无法执行转换 }
可能的输出:
-1.23e-08 0.012 1.5e+17 -107.75 inf nan inf 0 0
参考文献
- C23 标准 (ISO/IEC 9899:2024):
-
- 7.22.1.1 atof 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018):
-
- 7.22.1.1 atof 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011):
-
- 7.22.1.1 atof 函数 (p: 341)
- C99标准(ISO/IEC 9899:1999):
-
- 7.20.1.1 atof函数 (p: 307)
- C89/C90 标准 (ISO/IEC 9899:1990):
-
- 4.10.1.1 atof 函数
参阅
|
(C99)
(C99)
|
将字节字符串转换为浮点数值
(函数) |
|
C++ 文档
关于
atof
|
|