std::bit_width

Определено в заголовке `<bit>`
template< class T > constexpr int bit_width( T x ) noexcept;		(с C++20)

Если x не равно нулю, вычисляет количество битов, необходимых для хранения значения x, то есть, \(1 + \lfloor \log_2(x) \rfloor\)1 + floor(log₂(x)). Если x равно нулю, возвращает ноль.

Этот перегруз участвует в разрешении перегрузки только в том случае, если T является типом беззнакового целого числа (то есть, unsigned char, unsigned short, unsigned int, unsigned long, unsigned long long, или расширенным типом беззнакового целого числа).

Параметры

значение беззнакового целого числа

Возвращаемое значение

Ноль, если x равно нулю; в противном случае, единица плюс двоичный логарифм x, с отброшенной дробной частью.

Примечания

Эта функция эквивалентна return std::numeric_limits<T>::digits - std::countl_zero(x);.

Макроопределения проверки возможностей	Значение	Std	Функция
`__cpp_lib_int_pow2`	202002L	(C++20)	Операции с целыми степенями двойки (с C++20)

Пример

#include <bit>
#include <bitset>
#include <iostream>
 
int main()
{
    for (unsigned x{0}; x != 8; ++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++.

DR	Применено к	Поведение как опубликовано	Правильное поведение
LWG 3656	C++20	тип возвращаемого значения функции `bit_width` такой же, как тип аргумента функции	сделано `int`

См. также

countl_zero

(C++20)

считает количество последовательных 0 битов, начиная с старшего бита
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/bit_width