logbf

1-3）从浮点参数中提取无偏基本独立的指数的值arg，并将其作为浮点值返回。

4）类型 - 通用宏：如果arg有类型long double，logbl则被调用。否则，如果arg有整数类型或类型double，logb则调用。否则，logbf被调用。

形式上，无偏指数是log的有符号整数部分

[R |阿根廷| （由此函数作为浮点值返回），对于非零arg，其中r是FLT_RADIX。如果arg低于正常水平，则将其视为正常化。

参数

返回值

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

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

如果发生极错误-HUGE_VAL，-HUGE_VALF或-HUGE_VALL返回。

Error handling

按照math_errhandling中的指定报告错误。

如果arg为零，则可能会出现域或范围错误。

如果实现支持IEEE浮点运算（IEC 60559），

• 如果arg是±0，-∞返回并且FE_DIVBYZERO被提升。
• 如果arg是±∞，则返回+∞
• 如果arg是NaN，则返回NaN。
• 在所有其他情况下，结果是确切的（FE_INEXACT从不会提高），并且忽略当前舍入模式

笔记

如果arg是±0 ，POSIX要求发生极点错误。

由于归一化要求不同，返回的指数的值logb总是小于指数的返回值frexp：对于e返回的指数logb，| arg * re

| 介于1和r（通常介于1和之间2），但对于e由frexp| arg * 2-e 返回的指数

| 介于0.5和之间1。

例

比较不同的浮点分解函数。

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <fenv.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

参考

• C11标准（ISO / IEC 9899：2011）：
  • 7.12.6.11 logb函数（p：246）
  • 7.25类型通用数学<tgmath.h>（p：373-375）
  • F.10.3.11 logb函数（p：522）
• C99标准（ISO / IEC 9899：1999）：
  • 7.12.6.11 logb函数（p：227）
  • 7.22类型通用数学<tgmath.h>（p：335-337）
  • F.9.3.11 logb函数（p：459）