std:: logb, std:: logbf, std:: logbl

形式上，对于非零的 num ，无偏指数是指 log r |num| 的带符号整数部分（由本函数以浮点值形式返回），其中 r 是 std:: numeric_limits < T > :: radix ，而 T 是 num 的浮点类型。如果 num 是次正规数，则将其视为已正规化处理。

参数

返回值

若无错误发生，将返回 num 的无偏指数作为带符号浮点数值。

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

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

错误处理

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

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

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

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

注释

POSIX 要求 ，如果 num 为 ±0，则发生极点错误。

std::logb 返回的指数值始终比 std::frexp 返回的指数小 1，这是由于不同的归一化要求所致：对于 std::logb 返回的指数 e ， |num*r -e
| 的取值范围在 1 到 r 之间（通常为 1 到 2 ），而对于 std::frexp 返回的指数 e ， |num*2 -e
| 的取值范围在 0.5 到 1 之间。

额外的重载并不要求完全按照 (A) 提供。只需确保对于整数类型的实参 num ， std :: logb ( num ) 与 std :: logb ( static_cast < double > ( num ) ) 具有相同效果即可。

示例

#include <cfenv>
#include <cmath>
#include <iostream>
#include <limits>
// #pragma STDC FENV_ACCESS ON
int main()
{
    double f = 123.45;
    std::cout << "给定数值 " << f << " 或十六进制格式 " << std::hexfloat
              << f << std::defaultfloat << "，\n";
    double f3;
    double f2 = std::modf(f, &f3);
    std::cout << "modf() 生成 " << f3 << " + " << f2 << '\n';
    int i;
    f2 = std::frexp(f, &i);
    std::cout << "frexp() 生成 " << f2 << " * 2^" << i << '\n';
    i = std::ilogb(f);
    std::cout << "logb()/ilogb() 生成 " << f / std::scalbn(1.0, i) << " * "
              << std::numeric_limits<double>::radix
              << "^" << std::ilogb(f) << '\n';
    // 错误处理
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "logb(0) = " << std::logb(0) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    触发 FE_DIVBYZERO 异常\n";
}

给定数值 123.45 或十六进制格式 0x1.edccccccccccdp+6，
modf() 生成 123 + 0.45
frexp() 生成 0.964453 * 2^7
logb()/ilogb() 生成 1.92891 * 2^6
logb(0) = -Inf
    触发 FE_DIVBYZERO 异常

参见