NAME¶

std::independent_bits_engine::independent_bits_engine - std::independent_bits_engine::independent_bits_engine

Synopsis¶

independent_bits_engine(); (1) (since C++11)
explicit independent_bits_engine( result_type s ); (2) (since C++11)
template< class Sseq > (3) (since C++11)
explicit independent_bits_engine( Sseq& seq );
explicit independent_bits_engine( const Engine& e ); (4) (since C++11)
explicit independent_bits_engine( Engine&& e ); (5) (since C++11)

Constructs new pseudo-random engine adaptor.

1) Default constructor. The underlying engine is also default-constructed.
2) Constructs the underlying engine with s.
3) Constructs the underlying engine with seed sequence seq. This constructor only
participate in overload resolution if Sseq qualifies as a SeedSequence. In
particular, this constructor does not participate in overload resolution if Sseq is
implicitly convertible to result_type.
4) Constructs the underlying engine with a copy of e.
5) Move-constructs the underlying engine with e. e holds unspecified, but valid
state afterwards.

Parameters¶

s - integer value to construct the underlying engine with
seq - seed sequence to construct the underlying engine with
e - pseudo-random number engine to initialize with

Example¶

// Run this code

#include <iostream>
#include <random>

int main()
{
auto print = [](auto rem, auto engine, int count) {
std::cout << rem << ": ";
for (int i{}; i != count; ++i)
std::cout << static_cast<unsigned>(engine()) << ' ';
std::cout << '\n';
};

std::independent_bits_engine<std::mt19937, /*bits*/ 1, unsigned short>
e1; // default-constructed
print("e1", e1, 8);

std::independent_bits_engine<std::mt19937, /*bits*/ 1, unsigned int>
e2(1); // constructed with 1
print("e2", e2, 8);

std::random_device rd;
std::independent_bits_engine<std::mt19937, /*bits*/ 3, unsigned long>
e3(rd()); // seeded with rd()
print("e3", e3, 8);

std::seed_seq s{3,1,4,1,5};
std::independent_bits_engine<std::mt19937, /*bits*/ 3, unsigned long long>
e4(s); // seeded with seed-sequence s
print("e4", e4, 8);
}

Possible output:¶

e1: 0 0 0 1 0 1 1 1
e2: 1 1 0 0 1 1 1 1
e3: 3 1 5 4 3 2 3 4
e4: 0 2 4 4 4 3 3 6