Go math.Ilogb 为什么不能当作普通对数使用

如果你需要知道一个 float64 落在哪个二进制数量级，math.Ilogb 很方便；但它不是“把数字取以 2 为底的对数再四舍五入”。它返回浮点数科学表示中的整数指数，适合做分桶、规格化和数量级判断。需要连续对数时，应使用 math.Log2；需要同时拿到尾数和指数时，应使用 math.Frexp。

一句话记忆：Ilogb(8) 是 3，Ilogb(12) 也是 3；前者和后者的 Log2 结果并不相同。零、无穷大和 NaN 还会返回文档规定的哨兵值，不能当作普通指数继续参与业务计算。

先判断你要的是哪一种“指数”

对非零有限数 x，可以把它理解成 x = f × 2^e，其中 f 位于一个规范化区间。math.Ilogb(x) 返回的就是这个二进制表示里的整数 e。因此，1 到小于 2 的数返回 0，2 到小于 4 的数返回 1，4 到小于 8 的数返回 2，8 到小于 16 的数返回 3。它回答的是“属于哪个 2 的幂区间”，不是“精确对数是多少”。

例如，math.Ilogb(12) 返回 3，因为 12 位于 [8, 16)；而 math.Log2(12) 约为 3.585。把 Ilogb 的结果当作精确对数，会在阈值附近造成明显误判。

Log2、Ilogb 和 Frexp 怎么选

三个函数的目标不同，可以先按结果形态选择：

package main

import (
	"fmt"
	"math"
)

func main() {
	values := []float64{0.75, 1, 1.5, 8, 12}
	for _, value := range values {
		// Ilogb 用于数量级分桶，Log2 用于连续计算，Frexp 拆出尾数和指数。
		frac, exp := math.Frexp(value)
		fmt.Printf("x=%g ilogb=%d log2=%.3f frac=%g exp=%d\\n",
			value, math.Ilogb(value), math.Log2(value), frac, exp)
	}
}

如果代码只需要一个整数桶号，选 Ilogb；如果后续要做插值、比例或对数坐标，选 Log2；如果还要恢复原数，选 Frexp。不要因为三个函数都出现“指数”就混用返回值。

特殊值必须先和普通数分开

Go 官方文档规定：Ilogb(0) 返回 math.MinInt32，Ilogb(+Inf)、Ilogb(-Inf) 和 Ilogb(NaN) 返回 math.MaxInt32。这些值是接口约定的哨兵，不代表零真的处于极小的二进制区间，也不代表 NaN 有一个最大的指数。

生产代码中，建议先检查特殊值，再进入数量级计算。下面的封装把“不适合继续分桶”的输入转换成显式错误，调用方不会误把哨兵值写入统计数据。

package main

import (
	"fmt"
	"math"
)

// exponentBucket 只接收非零有限数，避免把 Ilogb 的哨兵值当作业务桶号。
func exponentBucket(x float64) (int, error) {
	// 先挡住 0、Inf 和 NaN，再使用普通有限数的二进制指数。
	if x == 0 || math.IsInf(x, 0) || math.IsNaN(x) {
		return 0, fmt.Errorf("x must be non-zero and finite: %v", x)
	}
	return math.Ilogb(x), nil
}

落地时记住这三个边界

• 要精确对数，用 Log2；要整数数量级，用 Ilogb；要尾数和指数，用 Frexp。
• 阈值判断要明确区间，例如 Ilogb(12)==3 只能说明 12 在 [8,16) 内。
• 零、无穷大、NaN 先分支处理，不能把 MinInt32 或 MaxInt32 当作真实指数。

相关问题

Ilogb 能替代 Log2 吗？ 不能。前者只保留整数二进制指数，后者返回连续的浮点对数。

为什么不用自己写位运算取指数？ 如果目标只是调用语义，优先使用标准库接口；自己拆 IEEE 754 位字段还要处理非规格化数和特殊值。

负数能传给 Ilogb 吗？ 可以，指数取决于绝对值的二进制数量级；但零、无穷大和 NaN 仍需按特殊规则处理。