# std::bitset<N>::flip

> C++ Atlas: `cppatlas.com/w/cpp/utility/bitset/flip` | Source: https://en.cppreference.com/w/cpp/utility/bitset/flip | Domain: Utility | Standards: C++11, C++23

Flips bits, i.e. changes true values to false and false values to true. Equivalent to a logical NOT operation on part or all of the bitset.

## Official Specification Summary (cppreference)

```cpp
bitset& flip(); // (1) (noexcept since C++11) (constexpr since C++23)
bitset& flip( std::size_t pos ); // (2) (constexpr since C++23)
```

Flips bits, i.e. changes `true` values to `false` and `false` values to `true`. Equivalent to a logical NOT operation on part or all of the bitset.

1) Flips all bits (like `operator~`, but in-place).

2) Flips the bit at the position `pos`.

### Parameters

- `pos` - the position of the bit to flip

### Return value

`*this`

### Exceptions

2) Throws `std::out_of_range` if `pos` does not correspond to a valid bit position.

### Example

```cpp
#include <bitset>
#include <iostream>

int main()
{
    std::bitset<4> flops;

    std::cout << flops << '\n'
              << flops.flip(0) << '\n'
              << flops.flip(2) << '\n'
              << flops.flip() << '\n';
}
```

Output:

```text
0000
0001
0101
1010
```

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 2250 | C++98 | the behavior was undefined if `pos` does not correspond to a valid bit position | always throws an exception in this case |

### See also

- [`set`](https://en.cppreference.com/w/cpp/utility/bitset/set): sets bits to `true` or given value (public member function)
- [`reset`](https://en.cppreference.com/w/cpp/utility/bitset/reset): sets bits to `false` (public member function)
- [`operator&=`](https://en.cppreference.com/w/cpp/utility/bitset/operator_logic), [`operator|=`](https://en.cppreference.com/w/cpp/utility/bitset/operator_logic), [`operator^=`](https://en.cppreference.com/w/cpp/utility/bitset/operator_logic), [`operator~`](https://en.cppreference.com/w/cpp/utility/bitset/operator_logic): performs binary AND, OR, XOR and NOT (public member function)
- [`flip`](https://en.cppreference.com/w/cpp/container/vector_bool/flip): flips all the bits (public member function of `std::vector<bool,Allocator>`)

---
Attribution: content from https://en.cppreference.com/w/cpp/utility/bitset/flip (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.