Namespaces
Variants

std::bit_ceil

来自 zh.cppreference.net
 
 
 
位操作
(C++20)
(C++23)
2 的整数幂2
(C++20)
(C++20)
(C++20)
移位
(C++29)
(C++29)
旋转
(C++20)
(C++20)
计数
(C++20)
(C++20)
(C++20)
排列
(C++29)
(C++29)
字节序
(C++20)
 
定义于头文件 <bit>
template< class T >
constexpr T bit_ceil( T x );
(自 C++20 起)

计算不小于 x 的最小的 2 的整数幂。

若该值在 T 中不可表示,则行为未定义。仅在未定义行为不发生的情况下,允许在常量求值中调用此函数。

仅当 T 为无符号整数类型(即 unsigned char, unsigned short, unsigned int, unsigned long, unsigned long long 或扩展的无符号整数类型)时,此重载参与重载决议。

参数

x - 无符号整数类型的值

返回值

不小于 x 的最小二次幂整数。

异常

不抛出任何异常。

注释

在 P1956R1 之前,此函数模板的拟议名称为 ceil2 。

功能测试 宏 值 标准 功能
__cpp_lib_int_pow2 202002L (C++20) 整型二次幂运算

可能的实现

查看可能的实现: libstdc++ (gcc) 和 libc++ (clang) 。

template<typename T, typename ... U>
concept neither = (!std::same_as<T, U> && ...);
template<std::unsigned_integral T>
    requires neither<T, bool, char, char8_t, char16_t, char32_t, wchar_t>
constexpr T bit_ceil(T x) noexcept
{
    if (x <= 1u)
        return T(1);
    if constexpr (std::same_as<T, decltype(+x)>)
        return T(1) << std::bit_width(T(x - 1));
    else
    {   // 针对受整型提升影响的类型
        constexpr int offset_for_ub =
            std::numeric_limits<unsigned>::digits - std::numeric_limits<T>::digits;
        return T(1u << (std::bit_width(T(x - 1)) + offset_for_ub) >> offset_for_ub);
    }
}

示例

#include <bit>
#include <bitset>
#include <iostream>
int main()
{
    using bin = std::bitset<8>;
    for (auto x{0U}; 0XA != x; ++x)
        std::cout << "bit_ceil( " << bin(x) << " ) = "
                  << bin(std::bit_ceil(x)) << '\n';
}

输出:

bit_ceil( 00000000 ) = 00000001
bit_ceil( 00000001 ) = 00000001
bit_ceil( 00000010 ) = 00000010
bit_ceil( 00000011 ) = 00000100
bit_ceil( 00000100 ) = 00000100
bit_ceil( 00000101 ) = 00001000
bit_ceil( 00000110 ) = 00001000
bit_ceil( 00000111 ) = 00001000
bit_ceil( 00001000 ) = 00001000
bit_ceil( 00001001 ) = 00010000

另请参阅

(C++20)
查找不大于给定值的最大二次幂整数
(函数模板)