home | help 
std::indepe..._bits_engine(3)  C++ Standard Libary std::indepe..._bits_engine(3)

NAME
     std::independent_bits_engine::independent_bits_engine    -    std::indepen-
     dent_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-con-
     structed.
	2) Constructs the underlying engine with s.
	3)  Constructs	the  underlying engine with seed sequence seq. This con-
     structor 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

http://cppreference.com 	   2024.06.10	   std::indepe..._bits_engine(3)
home | help