std::log2, std::log2f, std::log2l

在头文件 `<cmath>` 中定义
	(1)
float log2 ( float num ); double log2 ( double num ); long double log2 ( long double num );			(直到 C++23)
/* 浮点类型 / log2 ( / 浮点类型 */ num );			(自 C++23) (自 C++26 起为 constexpr)
float log2f( float num );		(2)	(自 C++11) (自 C++26 起为 constexpr)
long double log2l( long double num );		(3)	(自 C++11) (自 C++26 起为 constexpr)
其他重载 (自 C++11)
在头文件 `<cmath>` 中定义
template< class Integer > double log2 ( Integer num );		(A)	(自 C++26 起为 constexpr)

1-3) 计算 num 的二进制（以 2 为底）对数。库为所有 cv 无限定浮点类型提供了 std::log2 的重载，作为参数的类型。(自 C++23)

A) 为所有整数类型提供了其他重载，这些类型被视为 double。

(自 C++11)

[编辑] 参数

num

-

浮点数或整数值

[编辑] 返回值

如果未发生错误，则返回 num 的以 2 为底的对数（ $log 2 (num)$ 或 $lb(num)$ ）。

如果发生域错误，则返回实现定义的值（在支持的情况下为 NaN）。

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

[编辑] 错误处理

错误报告方式如 math_errhandling 中所指定。

如果 num 小于零，则发生域错误。

如果 num 为零，则可能发生极点错误。

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

如果参数为 ±0，则返回 -∞，并引发 FE_DIVBYZERO。
如果参数为 1，则返回 +0。
如果参数为负数，则返回 NaN，并引发 FE_INVALID。
如果参数为 +∞，则返回 +∞。
如果参数为 NaN，则返回 NaN。

[编辑] 注释

对于整数 num，二进制对数可以解释为输入中最高有效位 1 的零基索引。

其他重载不需要以 (A) 的方式提供。它们只需要足够，以确保对于它们的整数类型参数 num，std::log2(num) 与 std::log2(static_cast<double>(num)) 的效果相同。

[编辑] 示例

运行此代码

#include <cerrno>
#include <cfenv>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
 
int main()
{
    std::cout << "log2(65536) = " << std::log2(65536) << '\n'
              << "log2(0.125) = " << std::log2(0.125) << '\n'
              << "log2(0x020f) = " << std::log2(0x020f)
              << " (highest set bit is in position 9)\n"
              << "base-5 logarithm of 125 = "
              << std::log2(125) / std::log2(5) << '\n';
 
    // special values
    std::cout << "log2(1) = " << std::log2(1) << '\n'
              << "log2(+Inf) = " << std::log2(INFINITY) << '\n';
 
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "log2(0) = " << std::log2(0) << '\n';
 
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

可能的输出

log2(65536) = 16
log2(0.125) = -3
log2(0x020f) = 9.04166 (highest set bit is in position 9)
base-5 logarithm of 125 = 3
log2(1) = 0
log2(+Inf) = inf
log2(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

[编辑] 另请参阅

loglogflogl (C++11)(C++11)	计算自然（以 e 为底）对数 (${\small\ln{x}}$ $ln(x)$ ) (函数) [编辑]
log10log10flog10l (C++11)(C++11)	计算常用（以 10 为底）对数 (${\small\log_{10}{x}}$ $log 10 (x)$ ) (函数) [编辑]
log1plog1pflog1pl (C++11)(C++11)(C++11)	给定数字加 1 后以 e 为底的对数（${\small\ln{(1+x)}}$ $ln(1+x)$ ）。 (函数) [编辑]
exp2exp2fexp2l (C++11)(C++11)(C++11)	返回 2 的给定次幂（${\small 2^x}$ $2 x$ ）。 (函数) [编辑]
C 文档用于 log2

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作