strtod
在头文件<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
无视事件
- 非数字表达式。它由以下部分组成:
- (可选)加号或减号
NAN
或NAN(
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 ++文档 |
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com