Namespaces
Variants

atof

From cppreference.net
< c ‎ | string ‎ | byte
定义于头文件 <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( 字符序列  ) (NAN部分不区分大小写)。 字符序列 只能包含数字、拉丁字母和下划线。结果为静默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: 超出 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 函数

参阅

将字节字符串转换为浮点数值
(函数)
C++ 文档 关于 atof