logbl

logb, logbf, logbl

在头文件中定义
float logbf( float arg	(1)	(since C99)
double logb( double arg	(2)	(since C99)
long double logbl( long double arg	(3)	(since C99)
Defined in header <tgmath.h>
#define logb( arg )	(4)	(since C99)

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

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

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

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

参数

arg	-	浮点值

返回值

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

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

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

错误处理

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

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

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

如果arg是±0，-∞返回并且FE_DIVBYZERO被提升。

笔记

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

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

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

| 介于0.5和之间1。

Example

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

#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）：