std::bitset<N>::operator[]

bool operator[]( std::size_t pos ) const;	(1)	(constexpr с C++11)
reference operator[]( std::size_t pos );	(2)	(constexpr с C++23)

Обращается к биту в позиции pos.

1) Возвращает значение бита.

2) Возвращает объект типа std::bitset::reference, позволяющий изменить значение.

Если pos < size() имеет значение false, поведение не определено.

(до C++26)

Если pos < size() имеет значение false:

Если реализация использует усиленные проверки, происходит нарушение контракта.
Если реализация не использует усиленные проверки, поведение не определено.

(начиная с C++26)

Параметры

pos

позиция возвращаемого бита

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

1) Значение запрошенного бита.

2) Объект типа std::bitset::reference, позволяющий записывать значение запрошенного бита.

Исключения

Ничего не выбрасывает.

Пример

#include <bitset>
#include <cstddef>
#include <iostream>

int main()
{
    std::bitset<8> b1{0b00101010}; // binary literal for 42
    
    for (std::size_t i = 0; i < b1.size(); ++i)
        std::cout << "b1[" << i << "]: " << b1[i] << '\n';
    b1[0] = true; // modifies the first bit through bitset::reference
    
    std::cout << "After setting bit 0, b1 holds " << b1 << '\n';
}

Вывод:

b1[0]: 0
b1[1]: 1
b1[2]: 0
b1[3]: 1
b1[4]: 0
b1[5]: 1
b1[6]: 0
b1[7]: 0
After setting bit 0, b1 holds 00101011

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроспективно к ранее опубликованным стандартам C++.

DR	Применяется к	Опубликованное поведение	Правильное поведение
LWG 11	C++98	1. в стандарте C++ отсутствовало описание 2. существовала только неконстантная перегрузка	1. добавлено описание 2. добавлена константная перегрузка
LWG 907	C++98	поведение при чтении бита в позиции `pos` было эквивалентно поведению `test(pos)`, но `test()` может выбрасывать исключения	исключено упоминание `test()`

См. также

test	обращается к указанному биту (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/bitset/operator_at