atof

定义于头文件 `<stdlib.h>`
double atof( const char* str );

解释由 str 指向的字节字符串中的浮点值。

该函数丢弃任何空白字符（由 isspace 确定），直到找到第一个非空白字符。然后，它尽可能多地获取字符以形成有效的浮点表示，并将它们转换为浮点值。有效的浮点值可以是以下之一

十进制浮点表达式。它由以下部分组成

(可选) 加号或减号
非空十进制数字序列，可选地包含十进制小数点字符（由当前 C locale 确定）（定义有效位数）
(可选) e 或 E 后跟可选的减号或加号以及非空十进制数字序列（定义以 $10$ 为底的指数）

十六进制浮点表达式。它由以下部分组成

(可选) 加号或减号
0x 或 0X
非空十六进制数字序列，可选地包含十进制小数点字符（由当前 C locale 确定）（定义有效位数）
(可选) p 或 P 后跟可选的减号或加号以及非空十进制数字序列（定义以 $2$ 为底的指数）

无穷大表达式。它由以下部分组成

(可选) 加号或减号
INF 或 INFINITY，忽略大小写

非数字表达式。它由以下部分组成

(可选) 加号或减号
NAN 或 NAN(char_sequence)，忽略 NAN 部分的大小写。char_sequence 只能包含数字、拉丁字母和下划线。结果是一个静默 NaN 浮点值。

（自 C99 起）

任何其他可能被当前安装的 C locale 接受的表达式。

[编辑] 参数

str

-

指向要解释的空终止字节字符串的指针

[编辑] 返回值

double 成功时，对应于 str 内容的值。如果转换后的值超出返回类型的范围，则返回值是未定义的。如果无法执行转换，则返回 0.0。

[编辑] 注释

该名称代表 “ASCII to float”。

[编辑] 示例

运行此代码

#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: out of range of double
    printf("%g\n", atof("0.0"));
    printf("%g\n", atof("junk"));       // no conversion can be performed
}

可能的输出

-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 函数

[编辑] 参见

strtofstrtodstrtold (C99)(C99)	将字节字符串转换为浮点值 (函数) [编辑]
C++ 文档关于 atof

编译器支持
语言
头文件
类型支持
程序工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规格
符号索引

cppreference.cn

命名空间

变体

视图

操作