C++

参考

<cmath> (math.h)

函数
<cmath> <ctgmath>

ilogb

int ilogb  (double x);int ilogbf (float x);int ilogbl (long double x);
int ilogb (double x);int ilogb (float x);int ilogb (long double x);int ilogb (T x);           // additional overloads for integral types
整数二进制对数
返回|x|的对数的整数部分，使用FLT_RADIX作为对数的底。

这是机器内部用来表示浮点值x的指数，当它使用一个在1.0和FLT_RADIX之间的有效数时，因此，对于一个正数x

x = 有效数 * FLT_RADIX 指数

通常，FLT_RADIX是2，并且此函数返回的值比用frexp获得的指数小一（因为有效数的归一化范围是[1.0,2.0)而不是[0.5,1.0)）。

头文件 <tgmath.h> 提供了此函数的类型通用宏版本。
此头文件 (<cmath>) 中为整型提供了额外的重载：这些重载在计算前有效地将x转换为double（定义为T是任何整型）。

此函数可能会返回两个特定的宏常量来指示以下特殊情况
宏描述
FP_ILOGB0x为零
FP_ILOGBNANx是NaN

这些宏常量定义在同一个头文件 ( <cmath> ) 中。

参数

x
要返回其ilogb的值。

返回值

如果x是正常的，则为x的以FLT_RADIX为底的对数。
如果x是次正常的，返回的值对应于其归一化表示（负指数）。
如果x为零，则返回FP_LOGB0（一个特殊值，仅由此函数返回，在<cmath>中定义）。
如果x是无穷大，则返回INT_MAX。
如果x是NaN，则返回FP_ILOGBNAN（一个特殊值，仅由此函数返回，在<cmath>中定义）。
如果结果的量级太大，无法用返回类型的值表示，则函数返回一个未指定的值，并发生上溢范围错误。
x的零值、无穷值或NaN值也可能导致定义域错误或上溢范围错误。

如果发生定义域错误
- 并且 math_errhandling 设置了 MATH_ERRNO：全局变量 errno 会被设置为 EDOM。
- 并且 math_errhandling 设置了 MATH_ERREXCEPT：将引发 FE_INVALID。

如果发生上溢范围错误
- 并且 math_errhandling 设置了 MATH_ERRNO：全局变量 errno 被设置为 ERANGE。
- 并且 math_errhandling 设置了 MATH_ERREXCEPT：将引发 FE_OVERFLOW。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
/* ilogb example */
#include <stdio.h>      /* printf */
#include <math.h>       /* ilogb */

int main ()
{
  double param;
  int result;

  param = 10.0;
  result = ilogb (param);
  printf ("ilogb(%f) = %d\n", param, result);
  return 0;
}

输出

ilogb(10.000000) = 3


另见

logb
计算浮点底数对数 (函数)
log2
计算二进制对数 (函数)
pow
求幂 (函数)