在头文件中定义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
#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是±∞,则返回+∞
如果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。
Example
比较不同的浮点分解函数。
#include #include #include #include
#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.45frexp() makes 0.964453 * 2^7logb()/logb() make 1.928906 * 2^6logb(0) = -Inf
FE_DIVBYZERO raised
参考
C11标准(ISO / IEC 9899:2011):7.12.6.11 logb函数(p:246)
7.25类型通用数学(p:373-375)
F.10.3.11 logb函数(p:522)
C99标准(ISO / IEC 9899:1999):7.12.6.11 logb函数(p:227)
7.22类型通用数学(p:335-337)
F.9.3.11 logb函数(p:459)