std::logb, std::logbf, std::logbl
来自cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| 在标头 <cmath> 定义
|
||
| (1) | ||
float logb ( float num ); double logb ( double num ); long double logb ( long double num ); |
(C++23 前) | |
constexpr /* 浮点数类型 */ logb ( /* 浮点数类型 */ num ); |
(C++23 起) | |
float logbf( float num ); |
(2) | (C++11 起) (C++23 起为 constexpr) |
long double logbl( long double num ); |
(3) | (C++11 起) (C++23 起为 constexpr) |
| SIMD 重载 (C++26 起) |
||
| 在标头 <simd> 定义
|
||
template< /*math-floating-point*/ V > constexpr /*deduced-simd-t*/<V> logb ( const V& v_num ); |
(S) | (C++26 起) |
| 额外重载 (C++11 起) |
||
| 在标头 <cmath> 定义
|
||
template< class Integer > double logb ( Integer num ); |
(A) | (C++23 起为 constexpr) |
1-3) 从浮点数实参
num 提取独立于基底的无偏指数，并将它作为浮点数返回。标准库提供所有以无 cv 限定的浮点数类型作为形参的类型的 std::logb 重载。(C++23 起)|
S) SIMD 重载对
v_num 实施逐元素 std::logb。
|
(C++26 起) |
|
A) 为所有整数类型提供额外重载，将它们当做
double。 |
(C++11 起) |
正式而言，无偏指数是非零 num 的 logr|num| 的有符号整数部分（此函数作为浮点数值返回），其中 r 是 std::numeric_limits<T>::radix 而 T 是 num 的浮点数类型。如果 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 <limits>
#include <iostream>
// #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
参阅
(C++11)(C++11) |
将数分解为有效数字和以 2 为底的指数 (函数) |
(C++11)(C++11)(C++11) |
提取数的指数 (函数) |
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11) |
将数乘以 FLT_RADIX 的幂次 (函数) |
logb 的 C 文档
| |