Spec-Zone.ru › C++

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(log2(x)). Если x равно нулю, возвращает ноль.

Эта перегрузка участвует в разрешении перегрузки только в том случае, если T является беззнаковым целочисленным типом (то есть unsignedchar, unsignedshort, unsignedint, unsignedlong, unsignedlonglong или расширенным беззнаковым целочисленным типом).

Параметры

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

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

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

Примечания

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

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

Пример

#include <bit>
#include <bitset>
#include <iostream>

int main()
{
    for (unsigned x{}; x != 010; ++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/cpp/numeric/bit_width

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API