命名空间
变体
操作

atof

来自 cppreference.cn
< c‎ | string‎ | byte
 
C
 
字符串库
 
空终止字节字符串
 
在头文件 <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 - 指向要解释的空终止字节字符串的指针

[编辑] 返回值

成功时，返回对应于 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: 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 函数

[编辑] 另请参阅

(C99)(C99)
 将字节字符串转换为浮点值
(函数) [编辑]
C++ 文档 for atof
取自“https://cppreference.cn/mwiki/index.php?title=c/string/byte/atof&oldid=181410”