logb, logbf, logbl

形式上，对于非零的 arg ，无偏指数是指数部分的带符号整数值（由本函数以浮点值返回），其计算公式为 log r |arg| ，其中 r 是 FLT_RADIX 。若 arg 为次正规数，则按正规化处理。

参数

返回值

如果未发生错误，则返回 arg 的无偏指数作为带符号浮点值。

如果发生定义域错误，则返回一个实现定义的值。

如果出现极点错误，则返回 -HUGE_VAL 、 -HUGE_VALF 或 -HUGE_VALL 。

错误处理

错误报告方式遵循 math_errhandling 中的规范。

当 arg 为零时可能出现定义域或值域错误。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

• 如果 arg 为 ±0，则返回 -∞ 并引发 FE_DIVBYZERO 。
• 如果 arg 为 ±∞，则返回 +∞。
• 如果 arg 为 NaN，则返回 NaN。
• 其他所有情况下，结果都是精确的（永远不会引发 FE_INEXACT ）且忽略 当前舍入模式 。

注释

POSIX标准要求 ，若 arg 为±0时出现极点错误。

logb 返回的指数值始终比 frexp 返回的指数小 1 ，这是由于不同的归一化要求：对于 logb 返回的指数 e ， |arg*r -e
| 介于 1 和 r 之间（通常介于 1 和 2 ），而对于 frexp 返回的指数 e ， |arg*2 -e
| 则介于 0.5 和 1 之间。

示例

#include <fenv.h>
#include <float.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    double f = 123.45;
    printf("Given the number %.2f or %a in hex,\n", f, f);
    double f3;
    double f2 = modf(f, &f3);
    printf("modf() makes %.0f + %.2f\n", f3, f2);
    int i;
    f2 = frexp(f, &i);
    printf("frexp() makes %f * 2^%d\n", f2, i);
    i = logb(f);
    printf("logb()/logb() make %f * %d^%d\n", f/scalbn(1.0, i), FLT_RADIX, i);
    // error handling
    feclearexcept(FE_ALL_EXCEPT);
    printf("logb(0) = %f\n", logb(0));
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

Given the number 123.45 or 0x1.edccccccccccdp+6 in hex,
modf() makes 123 + 0.45
frexp() makes 0.964453 * 2^7
logb()/logb() make 1.928906 * 2^6
logb(0) = -Inf
    FE_DIVBYZERO raised

参考文献

参考