##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::bitset::test

From cppreference.com
< cpp‎ | utility‎ | bitset

bool test( size_t pos ) const; |  |

Returns the value of the bit at the position `pos`.

Unlike operator[], performs a bounds check and throws std::out_of_range if `pos` does not correspond to a valid position in the bitset.

### [edit] Parameters

pos | - | position of the bit to return

### [edit] Return value

true if the requested bit is set, false otherwise.

### [edit] Exceptions

std::out_of_range if `pos` does not correspond to a valid position within the bitset.

### [edit] Example

Run this code

    #include <iostream>
    #include <bitset>

    int main()
    {
        std::bitset<10> b1("1111010000");

        size_t idx = 0;
        while (idx < b1.size() && !b1.test(idx)) {
          ++idx;
        }

        if (idx < b1.size()) {
            std::cout << "lowest set bit at index " << idx << '\n';
        } else {
            std::cout << "no set bits\n";
        }
    }

Output:

    first set bit at index 4

### [edit] See also

operator[] | accesses specific bit (public member function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/utility/bitset/test&oldid=64205"