Namespaces
Variants

std::bitset<N>:: bitset

From cppreference.net
C++
Utilities library
std::bitset
bitset ( ) ;
(1) (noexcept начиная с C++11)
(constexpr начиная с 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) (константное выражение начиная с 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)
(константное выражение начиная с C++23)

Создает новый битовый набор из одного из нескольких возможных источников данных:

1) Конструктор по умолчанию. Создает битовый набор со всеми битами, установленными в ноль.
2) Создает битовый набор из целого числа без знака val .
Учитывая количество битов в представлении значения для unsigned long (до C++11) unsigned long long (начиная с C++11) как S :
  • Первые (крайние правые, младшие) std:: min ( S, N ) битовые позиции инициализируются соответствующими битовыми значениями из val .
  • Если S меньше N , оставшиеся битовые позиции инициализируются нулями.
3) Создает битовый набор, используя символы в 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 .

Эквивалентно bitset ( n == std:: basic_string < CharT > :: npos
? std:: basic_string < CharT > ( str )
: std:: basic_string < CharT > ( str, n ) , 0 , n, zero, one ) .

(до C++26)

Эквивалентно bitset ( n == std:: basic_string_view < CharT > :: npos
? std:: basic_string_view < CharT > ( str )
: std:: basic_string_view < CharT > ( str, n ) , 0 , n, zero, one ) .

(начиная с 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 .
5) 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
(публичная функция-член)