非常教程

C参考手册

字符串 | Strings

strtold

在头文件<stdlib.h>中定义

float strtof(const char * restrict str,char ** restrict str_end);

(自C99以来)

double strtod(const char * str,char ** str_end);

(直到C99)

double strtod(const char * restrict str,char ** restrict str_end);

(自C99以来)

long double strtold(const char * restrict str,char ** restrict str_end);

(自C99以来)

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

函数放弃任何空白字符(由std::isspace()决定),直到找到第一个非空白字符。然后,它需要尽可能多的字符来形成有效的浮点表示并将它们转换为浮点值。有效的浮点值可以是以下值之一:

  • 十进制浮点表达式。它由以下部分组成:
    • (可选)加号或减号
    • 非空十进制数字序列可选地包含小数点字符(由当前C确定locale)(定义有效数字)
    • (可选),e或者E跟随可选的负号或加号和非空序列的十进制数字(定义指数)
  • 二进制浮点表达式。它由以下部分组成:
    • (可选)加号或减号
    • 0x 要么 0X
    • 非空的十六进制数字序列可选地包含小数点字符(由当前C确定locale)(定义有效数字)
    • (可选),p或者P跟随可选的负号或加号和非空序列的十进制数字(定义指数)
  • 无限表达。它由以下部分组成:
    • (可选)加号或减号
    • INF或者INFINITY无视案件
  • 非数字表达式。它由以下部分组成:
    • (可选)加号或减号
    • NANNAN(char_sequence)忽略该NAN部分的情况。char_sequence只能包含字母数字字符。结果是静态的NaN浮点值。
  • 任何其他可能被当前安装的C接受的表达式 locale

这些函数将str_end指向的指针设置为指向经过最后解释的字符的字符。 如果str_end是NULL,它将被忽略。

参数

str

-

指向要解释的以空字符结尾的字节字符串

str_end

-

指向字符的指针。

返回值

浮点值对应str的成功内容。 如果转换后的值超出相应返回类型的范围,则会发生范围错误,并返回HUGE_VAL,HUGE_VALF或HUGE_VALL。 如果不能执行转换,则返回0。

#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
 
int main(void)
{
    // parsing with error handling
    const char *p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing '%s':\n", p);
    char *end;
    for (double f = strtod(p, &end); p != end; f = strtod(p, &end))
    {
        printf("'%.*s' -> ", (int)(end-p), p);
        p = end;
        if (errno == ERANGE){
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
 
    // parsing without error handling
    printf("\"  -0.0000000123junk\"  -->  %g\n", strtod("  -0.0000000123junk", NULL));
    printf("\"junk\"                 -->  %g\n", strtod("junk", NULL));
}

可能的输出:

Parsing '111.11 -2.22 Nan inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz':
'111.11' -> 111.110000
' -2.22' -> -2.220000
' Nan' -> nan
' nan(2)' -> nan
' inF' -> inf
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf
"  -0.0000000123junk"  -->  -1.23e-08
"junk"                 -->  0

参考

  • C11标准(ISO / IEC 9899:2011):
    • 7.22.1.3 strtod,strtof和strtold函数(p:342-344)
  • C99标准(ISO / IEC 9899:1999):
    • 7.20.1.3 strtod,strtof和strtold函数(p:308-310)
  • C89 / C90标准(ISO / IEC 9899:1990):
    • 4.10.1.4 strtod函数

扩展内容

ATOF

将字节字符串转换为浮点值(函数)

wcstofwcstodwcstold(C99)(C95)(C99)

将宽字符串转换为浮点值(函数)

| 用于strtof,strtod,strtold的C ++文档 |

C

C 语言是一门通用计算机编程语言,应用广泛。C 语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。