std::bitset<N>::bitset
Материал из cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| (1) | ||
bitset(); |
(до C++11) | |
constexpr bitset() noexcept; |
(начиная с C++11) | |
| (2) | ||
bitset( unsigned long val ); |
(до C++11) | |
constexpr bitset( unsigned long long val ) noexcept; |
(начиная с C++11) | |
template< class CharT, class Traits, class Alloc > explicit bitset( const std::basic_string<CharT, Traits, Alloc>& str, typename std::basic_string<CharT, Traits, Alloc>::size_type pos = 0, typename std::basic_string<CharT, Traits, Alloc>::size_type n = std::basic_string<CharT, Traits, Alloc>::npos, CharT zero = CharT('0'), CharT one = CharT('1') ); |
(3) | (constexpr начиная с C++23) |
template< class CharT, class Traits > constexpr explicit bitset( std::basic_string_view<CharT, Traits> str, std::size_t pos = 0, std::size_t n = std::size_t(-1), CharT zero = CharT('0'), CharT one = CharT('1') ); |
(4) | (начиная с C++26) |
template< class CharT > explicit bitset( const CharT* str, std::size_t n = std::size_t(-1), CharT zero = CharT('0'), CharT one = CharT('1') ); |
(5) | (начиная с C++11) (constexpr начиная с C++23) |
Создаёт новый набор битов из одного из нескольких необязательных источников данных:
1) Конструктор по умолчанию. Создаёт набор битов, все биты которого установлены в ноль.
2) Создаёт набор битов, инициализируя первые (самые правые, наименее значащие) битовые позиции
Если
M соответствующими значениями битов из val, где M меньше чем
Nи
|
(до C++11) |
|
(начиная с C++11) |
M меньше N, оставшиеся битовые позиции инициализируются нулями.3) Создаёт набор битов, используя символы из std::basic_string
str. Можно указать необязательную начальную позицию pos и длину n, а также символы, обозначающие альтернативные значения для установки (one) или сброса (zero) битов. Traits::eq() используется для сравнения значений символов. Эффективная длина строки инициализации равна
std::min(n, str.size() - pos). Если
pos > str.size(), то этот конструктор вызовет исключение std::out_of_range. Если какой-либо символ, проверенный в str, не является zero или one, этот конструктор вызовет исключение std::invalid_argument.4) Аналогично (3), но использует std::basic_string_view вместо std::basic_string.
5) Аналогично (3), но использует
const CharT* вместо std::basic_string. Эквивалентно bitset(n == std::size_t(-1)
? basic_string<CharT>(str)
: basic_string<CharT>(str, n), 0, n, zero, one)
|
Этот конструктор может динамически выделять память, хотя реализации обычно избегают динамического выделения. |
(до C++26) |
|
Этот конструктор не выделяет память динамически, как будто задействован только std::basic_string_view. |
(начиная с C++26) |
Параметры
| val | — | число, используемое для инициализации набора битов |
| str | — | строка, используемая для инициализации набора битов |
| pos | — | начальное смещение в str
|
| n | — | количество символов, которое будет использовано из str
|
| one | — | альтернативный символ для установленного бита в строке str
|
| zero | — | альтернативный символ для сброшенного бита в строке str
|
Исключения
3,4) std::out_of_range, если
pos > str.size(), std::invalid_argument, если какой-либо символ не равен единице или нулю5) std::invalid_argument, если какой-либо символ не равен единице или нулю
Примечание
| Макрос тест функциональности | |||
|---|---|---|---|
__cpp_lib_constexpr_bitset |
202207L |
(C++23) | Ещё один constexpr std::bitset, перегружает (3,5)
|
__cpp_lib_bitset |
202306L |
(C++26) | Взаимодействие std::bitset с std::string_view, (4)
|
Пример
Запустить этот код
#include <bitset>
#include <string>
#include <iostream>
#include <climits>
int main()
{
// пустой конструктор (1)
std::bitset<8> b1; // [0,0,0,0,0,0,0,0]
// конструктор из unsigned long long (2)
std::bitset<8> b2(42); // [0,0,1,0,1,0,1,0]
std::bitset<70> bl(ULLONG_MAX); // [0,0,0,0,0,0,1,1,1,...,1,1,1] для C++11
std::bitset<8> bs(0xfff0); // [1,1,1,1,0,0,0,0]
// конструктор из строки (3)
std::string bit_string = "110010";
std::bitset<8> b3(bit_string); // [0,0,1,1,0,0,1,0]
std::bitset<8> b4(bit_string, 2); // [0,0,0,0,0,0,1,0]
std::bitset<8> b5(bit_string, 2, 3); // [0,0,0,0,0,0,0,1]
// конструктор из строки с использованием пользовательских цифр нуль/один (4)
std::string alpha_bit_string = "aBaaBBaB";
std::bitset<8> b6(alpha_bit_string, 0, alpha_bit_string.size(),
'a', 'B'); // [0,1,0,0,1,1,0,1]
// конструктор char* с использованием пользовательских цифр (5)
std::bitset<8> b7("XXXXYYYY", 8, 'X', 'Y'); // [0,0,0,0,1,1,1,1]
std::cout << b1 << '\n' << b2 << '\n' << bl << '\n' << bs << '\n'
<< b3 << '\n' << b4 << '\n' << b5 << '\n' << b6 << '\n'
<< b7 << '\n';
}
Вывод:
00000000
00101010
0000001111111111111111111111111111111111111111111111111111111111111111
11110000
00110010
00000010
00000001
01001101
00001111
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| LWG 396 | C++98 | значения нулевого и единичного символов для перегрузки (3) это 0 и 1 (которые не соответствуют '0' и '1')
|
добавлены параметры для предоставления значений для этих символов |
| LWG 457 | C++98 | M меньше N и значения CHAR_BIT * sizeof(unsigned long)для перегрузки (2), но unsigned long не гарантируетиспользование всех своих битов для представления своего значения |
вместо этого учитывает количество битов представления значения |
Смотрите также
устанавливает биты в true или в заданное значение (public функция-элемент) | |
устанавливает биты в false (public функция-элемент) |