命名空间
变体
操作

atof

来自 cppreference.com
< c‎ | string‎ | byte
定义在头文件 <stdlib.h>
double atof( const char* str );

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

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

  • 十进制浮点表达式。它由以下部分组成
  • (可选) 加号或减号
  • 非空的十进制数字序列,其中可能包含小数点字符(由当前 C 区域设置 确定)(定义尾数)
  • (可选) eE 后面是可选的减号或加号,以及非空的十进制数字序列(定义以 10 为底的指数)
  • 十六进制浮点表达式。它由以下部分组成
  • (可选) 加号或减号
  • 0x0X
  • 非空的十六进制数字序列,其中可能包含小数点字符(由当前 C 区域设置 确定)(定义尾数)
  • (可选) pP 后面是可选的减号或加号,以及非空的十进制数字序列(定义以 2 为底的指数)
  • 无穷大表达式。它由以下部分组成
  • (可选) 加号或减号
  • INFINFINITY,不区分大小写
  • 非数表达式。它由以下部分组成
  • (可选) 加号或减号
  • NANNAN(char_sequence),不区分 NAN 部分的大小写。char_sequence 只能包含数字、拉丁字母和下划线。结果是一个静默 NaN 浮点值。
(自 C99)
  • 当前安装的 C 区域设置 可能接受的任何其他表达式

内容

[编辑] 参数

str - 指向要解释的以 null 结尾的字节字符串的指针

[编辑] 返回值

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

[编辑] 说明

这个名字代表“ASCII 到浮点数”。

[编辑] 示例

#include <stdlib.h>
#include <stdio.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

[编辑] 参考资料

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

[编辑] 另请参见

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