std::bitset<N>::bitset
С сайта ru.cppreference.net
bitset();
|
(1) | (noexcept начиная с C++11) (constexpr начиная с C++11) |
bitset( unsigned long val );
|
(2) | (до 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) |
Создаёт новый bitset из одного из нескольких возможных источников данных:
1) Конструктор по умолчанию. Создаёт bitset со всеми битами, установленными в ноль.
2) Создаёт bitset из беззнакового целого числа
val. Учитывая число битов в представлении значения
unsigned long(до C++11)unsigned long long(начиная с C++11) как S:
- Первые (самые правые, наименее значимые)
std::min(S, N)битовых позиций инициализируются соответствующими битовыми значениямиval. - Если
Sменьше, чемN, оставшиеся битовые позиции инициализируются нулями.
3) Создаёт bitset, используя символы в
str. Можно указать необязательную начальную позицию pos и длину n, а также символы, обозначающие альтернативные значения для установленных (one) и сброшенных (zero) битов. Traits::eq() используется для сравнения символьных значений. Эффективная длина инициализирующей строки равна
std::min(n, str.size() - pos).4) Аналогично (3), но использует std::basic_string_view вместо std::basic_string.
5) Аналогично (3), но использует
const CharT* вместо std::basic_string.
|
Эквивалентно |
(до C++26) |
|
Эквивалентно |
(начиная с C++26) |
Параметры
| val | - | число, используемое для инициализации битового набора |
| str | - | строка, используемая для инициализации битового набора |
| pos | - | начальное смещение в str |
| n | - | количество символов для использования из str |
| zero | - | альтернативный символ для сброшенных битов в str |
| one | - | альтернативный символ для установленных битов в str |
Исключения
3,4)
std::out_of_range
если
pos
>
str.
size
(
)
,
std::invalid_argument
если любой символ не является
one
или
zero
.
Примечания
| Макрос тестирования возможностей | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_constexpr_bitset
|
202207L
|
(C++23) |
Более константное выражение
std::bitset
, перегрузки
(
3,5
)
|
__cpp_lib_bitset
|
202306L
|
(C++26) |
Взаимодействие
std::bitset
с
std::string_view
,
(
4
)
|
Пример
Запустить этот код
#include <bitset> #include <climits> #include <iostream> #include <string> 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] // строковый конструктор с пользовательскими символами (3) 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: " << b1 << "\nb2: " << b2 << "\nbl: " << bl << "\nbs: " << bs << "\nb3: " << b3 << "\nb4: " << b4 << "\nb5: " << b5 << "\nb6: " << b6 << "\nb7: " << b7 << '\n'; }
Возможный вывод:
b1: 00000000 b2: 00101010 bl: 0000001111111111111111111111111111111111111111111111111111111111111111 bs: 11110000 b3: 00110010 b4: 00000010 b5: 00000001 b6: 01001101 b7: 00001111
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 396 | C++98 |
значения символов нуля и единицы для перегрузки
(3)
были 0 и 1 (что не соответствует '0' и '1' ) |
добавлены параметры для предоставления
значений этих символов |
| LWG 457 | C++98 |
S
был
CHAR_BIT
*
sizeof
(
unsigned
long
)
для перегрузки (2) , но unsigned long не гарантирует использование всех битов для представления своего значения |
учитывать количество
битов представления значения вместо этого |
| LWG 2250 | C++98 | поведение было неопределенным, если pos > str. size ( ) равно true |
всегда выбрасывает
исключение в этом случае |
Смотрите также
|
устанавливает биты в
true
или заданное значение
(публичная функция-член) |
|
|
устанавливает биты в
false
(публичная функция-член) |