Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

ilogb，ilogbf，ilogbl-获取浮点值的整数指数

语法

＃包括

int ilogb(双倍x);
int ilogbf(float x);
int ilogbl(long double x);

与-lm链接。

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

ilogb()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE>= 500 || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

ilogbl():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数将其参数的指数部分作为有符号整数返回。如果没有错误发生，则这些函数等效于转换为int的相应logb(3)函数。

返回值

成功后，这些函数将x的指数作为有符号整数返回。

如果x为零，则发生域错误，并且函数返回FP_ILOGB0。

如果x是NaN，则将发生域错误，并且函数将返回FP_ILOGBNAN。

如果x为负无穷大或正无穷大，则会发生域错误，并且函数将返回INT_MAX。

错误说明

有关如何确定调用这些函数时是否发生错误的信息，请参见math_error(7)。

可能会发生以下错误：

Domain error: xis 0 or a NaN

引发了无效的浮点异常(FE_INVALID)，并且将errno设置为EDOM(但请参见BUGS)。

Domain error: xis an infinity

引发了无效的浮点异常(FE_INVALID)，并且将errno设置为EDOM(但请参见BUGS)。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

C99，POSIX.1-2001，POSIX.1-2008。

BUGS

在版本2.16之前，这些功能的glibc实现中存在以下错误：

*

x为0或NaN的域错误情况未导致设置errno或(在某些体系结构上)引发浮点异常。

*

x为无穷大的域错误情况不会导致设置errno或引发浮点异常。

另外参见

log(3)，logb(3)，有效位数(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。