20 General utilities library [utilities]

20.6 Class template bitset [template.bitset]

20.6.2 bitset members [bitset.members]

bitset<N>& operator&=(const bitset<N>& rhs) noexcept;

1

Effects: Clears each bit in *this for which the corresponding bit in rhs is clear, and leaves all other bits unchanged.

2

Returns: *this.

bitset<N>& operator|=(const bitset<N>& rhs) noexcept;

3

Effects: Sets each bit in *this for which the corresponding bit in rhs is set, and leaves all other bits unchanged.

4

Returns: *this.

bitset<N>& operator^=(const bitset<N>& rhs) noexcept;

5

Effects: Toggles each bit in *this for which the corresponding bit in rhs is set, and leaves all other bits unchanged.

6

Returns: *this.

bitset<N>& operator<<=(size_t pos) noexcept;

7

Effects: Replaces each bit at position I in *this with a value determined as follows:

  • (7.1)

    If I < pos, the new value is zero;

  • (7.2)

    If I >= pos, the new value is the previous value of the bit at position I - pos.

8

Returns: *this.

bitset<N>& operator>>=(size_t pos) noexcept;

9

Effects: Replaces each bit at position I in *this with a value determined as follows:

  • (9.1)

    If pos >= N - I, the new value is zero;

  • (9.2)

    If pos < N - I, the new value is the previous value of the bit at position I + pos.

10

Returns: *this.

bitset<N>& set() noexcept;

11

Effects: Sets all bits in *this.

12

Returns: *this.

bitset<N>& set(size_t pos, bool val = true);

13

Requires: pos is valid

14

Throws: out_of_range if pos does not correspond to a valid bit position.

15

Effects: Stores a new value in the bit at position pos in *this. If val is nonzero, the stored value is one, otherwise it is zero.

16

Returns: *this.

bitset<N>& reset() noexcept;

17

Effects: Resets all bits in *this.

18

Returns: *this.

bitset<N>& reset(size_t pos);

19

Requires: pos is valid

20

Throws: out_of_range if pos does not correspond to a valid bit position.

21

Effects: Resets the bit at position pos in *this.

22

Returns: *this.

bitset<N> operator~() const noexcept;

23

Effects: Constructs an object x of class bitset<N> and initializes it with *this.

24

Returns: x.flip().

bitset<N>& flip() noexcept;

25

Effects: Toggles all bits in *this.

26

Returns: *this.

bitset<N>& flip(size_t pos);

27

Requires: pos is valid

28

Throws: out_of_range if pos does not correspond to a valid bit position.

29

Effects: Toggles the bit at position pos in *this.

30

Returns: *this.

unsigned long to_ulong() const;

31

Throws: overflow_error if the integral value x corresponding to the bits in *this cannot be represented as type unsigned long.

32

Returns: x.

unsigned long long to_ullong() const;

33

Throws: overflow_error if the integral value x corresponding to the bits in *this cannot be represented as type unsigned long long.

34

Returns: x.

template <class charT = char, class traits = char_traits<charT>, class Allocator = allocator<charT> > basic_string<charT, traits, Allocator> to_string(charT zero = charT('0'), charT one = charT('1')) const;

35

Effects: Constructs a string object of the appropriate type and initializes it to a string of length N characters. Each character is determined by the value of its corresponding bit position in *this. Character position N - 1 corresponds to bit position zero. Subsequent decreasing character positions correspond to increasing bit positions. Bit value zero becomes the character zero, bit value one becomes the character one.

36

Returns: The created object.

size_t count() const noexcept;

37

Returns: A count of the number of bits set in *this.

constexpr size_t size() const noexcept;

38

Returns: N.

bool operator==(const bitset<N>& rhs) const noexcept;

39

Returns: true if the value of each bit in *this equals the value of the corresponding bit in rhs.

bool operator!=(const bitset<N>& rhs) const noexcept;

40

Returns: true if !(*this == rhs).

bool test(size_t pos) const;

41

Requires: pos is valid

42

Throws: out_of_range if pos does not correspond to a valid bit position.

43

Returns: true if the bit at position pos in *this has the value one.

bool all() const noexcept;

44

Returns: count() == size()

bool any() const noexcept;

45

Returns: count() != 0

bool none() const noexcept;

46

Returns: count() == 0

bitset<N> operator<<(size_t pos) const noexcept;

47

Returns: bitset<N>(*this) <<= pos.

bitset<N> operator>>(size_t pos) const noexcept;

48

Returns: bitset<N>(*this) >>= pos.

constexpr bool operator[](size_t pos) const;

49

Requires: pos shall be valid.

50

Returns: true if the bit at position pos in *this has the value one, otherwise false.

51

Throws: Nothing.

bitset<N>::reference operator[](size_t pos);

52

Requires: pos shall be valid.

53

Returns: An object of type bitset<N>::reference such that (*this)[pos] == this->test(pos), and such that (*this)[pos] = val is equivalent to this->set(pos, val).

54

Throws: Nothing.

55

Remark: For the purpose of determining the presence of a data race ([intro.multithread]), any access or update through the resulting reference potentially accesses or modifies, respectively, the entire underlying bitset.