Namespaces
Variants

std:: bit_ceil

From cppreference.net
C++
Utilities library
Bit manipulation
헤더 파일에 정의됨 <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 이상인 가장 작은 2의 정수 거듭제곱.

예외

아무것도 던지지 않습니다.

참고 사항

P1956R1 이전에는, 이 함수 템플릿의 제안된 이름이 ceil2 이었습니다.

기능 테스트 매크로 값 표준 기능
__cpp_lib_int_pow2 202002L (C++20) 정수 2의 거듭제곱 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의 정수 거듭제곱을 찾음
(함수 템플릿)