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

参考文献

関連項目