std::bit_ceil

出自cppreference.com
< cpp‎ | numeric
在2025年5月1日 (四) 13:38由YexuanXiao對話 | 貢獻所做的修訂版本

(差異) ←上一修訂 | 最新修訂 (差異) | 下一修訂→ (差異)
 
 
 
位操縱
(C++20)
(C++23)
二的整數次冪
bit_ceil
(C++20)
(C++20)
(C++20)
旋轉
(C++20)
(C++20)
計數
(C++20)
(C++20)
(C++20)
端序
(C++20)
 
在標頭 <bit> 定義
template< class T >
constexpr T bit_ceil( T x );
(C++20 起)

計算不小於 x 的最小的二的整數次冪。

若值不能以 T 表示,則行為未定義。僅若不出現未定義行為才容許在常量求值中調用此函數。

此重載只有在 T 為無符號整數類型(即 unsigned charunsigned shortunsigned intunsigned longunsigned long long 或擴展無符號整數類型)時才會參與重載決議。

目錄

[編輯] 參數

x - 無符號整數

[編輯] 返回值

不小於 x 的最小的二的整數次冪。

[編輯] 異常

不拋出。

[編輯] 註解

P1956R1 以前,為這個函數模板提出的名字是 ceil2

功能特性測試 標準 功能特性
__cpp_lib_int_pow2 202002L (C++20) 2 的整數次冪運算

[編輯] 可能的實現

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)
尋找不大於給定值的最大的 2 的整數次冪
(函數模板) [編輯]