std::bit_width

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

数值库

常用数学函数

数学特殊函数 (C++17)

数学常数 (C++20)

浮点环境 (C++11)

复数

数值数组

伪随机数生成

因数运算

gcd (C++17)

lcm (C++17)

插值

midpoint (C++20)

lerp (C++20)

泛型数值运算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

位操作

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

在标头 <bit> 定义
template< class T > constexpr int bit_width( T x ) noexcept;		(C++20 起)

若 x 非零，则计算存储值 x 所需的位数，即 \(1 + \lfloor \log_2(x) \rfloor\)1 + floor(log
2(x)) 。若 x 为零，则返回零。

此重载只有在 T 为无符号整数类型（即 unsigned char 、 unsigned short 、 unsigned int 、 unsigned long 、 unsigned long long 或扩展无符号整数类型）时才会参与重载决议。

返回值

若 x 为零则为零；否则为一加 x 的 2 为底的对数，舍弃任何小数部分。

注解

此函数等价于 return std::numeric_limits<T>::digits - std::countl_zero(x); 。

功能特性测试宏
__cpp_lib_int_pow2

示例

运行此代码

#include <bit>
#include <bitset>
#include <iostream>
 
auto main() -> int
{
    for (unsigned x{0u}; x != 8u; ++x)
    {
        std::cout
            << "bit_width( "
            << std::bitset<4>{x} << " ) = "
            << std::bit_width(x) << '\n';
    }
}

输出：

bit_width( 0000 ) = 0
bit_width( 0001 ) = 1
bit_width( 0010 ) = 2
bit_width( 0011 ) = 2
bit_width( 0100 ) = 3
bit_width( 0101 ) = 3
bit_width( 0110 ) = 3
bit_width( 0111 ) = 3

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 3656	C++20	bit_width 的返回类型与其函数参数类型相同	使返回类型为 int

参阅

countl_zero (C++20)

从最高位起计量连续的 0 位的数量 (函数模板)