Open In App

random header in C++ | Set 1(Generators)

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

This header introduces random number generation facilities. This library allows to produce random numbers using combinations of generators and distributions.

  • Generators: Objects that generate uniformly distributed numbers.
  • Distributions: Objects that transform sequences of numbers generated by a generator into sequences of numbers that follow a specific random variable distribution, such as uniform, Normal or Binomial.

Generators

I. Pseudo-random number engines: They use an algorithm to generate random numbers based on an initial seed. These are:

random number engines

1. linear_congruential_engine: It is the simplest engine in the STL library that generates random unsigned integer numbers. It follows: 

 x = (a.x +c) mod m 
Where x= current state value  
            a = multiplier parameter ; if m is not zero, 
            this parameter should be lower than m.
            c = increment parameter ; if m is not zero, 
            this parameter should be lower than m.
            m = modulus parameter 
  • operator(): It generates random number.
  • min: It gives the minimum value returned by member operator().
  • max: It gives the maximum value returned by member operator().

C++




// C++ program to illustrate
// the use of operator(), max and min
// in linear_congruential_engine
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
 
// driver program
int main ()
{
 
    // finds the time between the system clock
    //(present time) and clock's epoch
    unsigned seed = chrono::system_clock::now().time_since_epoch().count();
     
    // minstd_rand0 is a standard
    // linear_congruential_engine
    minstd_rand0 generator (seed);
     
    // generates the random number
    cout << generator() << " is a random number between ";
     
    //use of min and max functions
    cout << generator.min() << " and " << generator.max();
     
    return 0;
}


Output:

211182246 is a random number between 1 and 2147483646

2. mersenne_twister_engine: It is a random number engine based on Mersenne Twister algorithm. It produces high quality unsigned integer random numbers in the interval [0, (2^w)-1].
where ‘w’ is word size: Number of bits of each word in the state sequence. 

  • operator(): It generates the random number.
  • min: It returns the minimum value returned by member operator(), which for mersenne_twister_engine is always zero.
  • max: It returns the maximum value returned by member operator(), which for mersenne_twister_engine is 2w-1 (where w is the word size).

C++




// C++ program to illustrate the use of
// operator(), min and max
// in mersenne_twister_engine
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
 
// Driver program
int main ()
{
     
    // finds the time between the system clock
    // (present time) and clock's epoch
    unsigned seed = chrono::system_clock::now().time_since_epoch().count();
     
    // mt19937 is a standard mersenne_twister_engine
    mt19937 generator (seed);
     
    // use of operator()
    cout << generator() << " is a random number between ";
     
    // use of max and min
    cout << generator.min() << " and " << generator.max();
     
    return 0;
}


Output:

3348201622 is a random number between 0 and 4294967295

3. subtract_with_carry_engine: It is a pseudo-random number generator engine that produces unsigned integer numbers.
The algorithm used is a lagged fibonacci generator, with a state sequence of r integer elements, plus one carry value.

  • operator(): It generates the random number.
  • max: It returns the maximum value returned by member operator(), which is (2^w)-1 for subtract_with_carry_engine , where ‘w’ is the word size.
  • min: It returns the minimum value returned by member operator(), which is always zero for subtract_with_carry_engine.

C++




// C++ program to illustrate the use of
// operator(), min and max
// in subtract_with_carry_engine
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
 
// Driver program
int main ()
{
     
    // finds the time between the system clock
    // (present time) and clock's epoch
    unsigned seed = chrono::system_clock::now().time_since_epoch().count();
     
    subtract_with_carry_engine<unsigned, 24, 10, 24> generator (seed);
     
    // use of operator()
    cout << generator() << " is a random number between ";
     
    // use of min and max
    cout << generator.min() << " and " << generator.max();
 
    return 0;
}


Output:

8606455 is a random number between 0 and 16777215

II. Random number generator: It is a random number generator that produces non-deterministic random numbers.

  • random_device: It is the true random number generator.
  • operator(): It returns a new random number.
  • min: It returns the minimum value returned by member operator(), which for random_device is always zero.
  • max: It returns the maximum value returned by member operator().

C++




// C++ program to illustrate the use of
// operator(), min and max
// in random_device
#include <iostream>
#include <random>
using namespace std;
 
//Driver program
int main ()
{
    random_device example;
     
    cout << "default random_device characteristics:" << endl;
     
    // use of min
    cout << "minimum: " << example.min() << endl;
     
    // use of max
    cout << "maximum: " << example.max() << endl;
     
    // use of entropy
    cout << "entropy: " << example.entropy() << endl;
     
    // use of operator()
    cout << "a random number: " << example() << endl;
     
    return 0;
}


Output:

default random_device characteristics:
minimum: 0
maximum: 4294967295
entropy: 0
a random number: 3705944883

III. Pseudo-random number engines (instantiations): These are the particular instantiations of generator engines and adaptors:

Pseudo-random number engines (instantiations)

1. default_random_engine: This is a random number engine class that generates pseudo-random numbers.

  • min: It returns the minimum value given by operator().
  • max: It returns the maximum value given by operator().
  • operator(): It returns a new random number.
    The function changes the internal state by one, which modifies the state value according to the given algorithm:
 x= (a.x + c)mod m
 Where x= current state value
 a and c = respective class template parameters
 m = class template parameter 

C++




// C++ program to illustrate the use of 
// operator(), min and max
// in default_random_engine 
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
// Driver program 
int main ()
{
       
    // finds the time between the system clock
    // (present time) and clock's epoch 
    unsigned seed = chrono::system_clock::now().time_since_epoch().count();
       
    // minstd_rand0 is a standard linear_congruential_engine
    minstd_rand0 generator (seed); 
       
    // generates the random number
    cout << generator() << " is a random number between ";
       
    // Use of min and max
    cout << generator.min() << " and " << generator.max();
       
    return 0;
}


Output:

201066682 is a random number between 1 and 2147483646

2. minstd_rand: It generates pseudo random numbers; it is similar to linear congruential generator

  • operator(): It returns a new random number. The function changes the internal state by one, which modifies the state value according to the following algorithm:
x = (a.x + c) mod m
where x= current state value
a ,c and m=class template parameter
  • min: It returns the minimum value given by member operator().
  • max: It returns the maximum value given by member operator(), which for linear_congruential_engine is (modulus-1).

C++




// C++ program to illustrate
// the use of operator(), max and min
// in minstd_rand
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
//Driver program
int main ()
{
       
   // finds the time between the system clock
  //(present time) and clock's epoch   
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
     
  // minstd_rand0 is a standard
  //linear_congruential_engine
  minstd_rand0 generator (seed);
     
  // use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

489592737 is a random number between 1 and 2147483646

3. mt19937: It is Mersenne Twister 19937 generator.It is a pseudo-random generator of 32-bit numbers with a state size of 19937 bits.

  • operator(): It generates a random number. The function changes the internal state by one using a transition algorithm that produces a twist on the selected element.
  • max: It returns the maximum value given by operator().
  • min: It returns the minimum value given by operator().
     

C++




// C++ program to illustrate the 
// use of operator(),min and max 
// in mt19937
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
// Driver program
int main ()
{
       
  // finds the time between the system clock
  //(present time) and clock's epoch     
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
     
  // mt19937 is a standard 
  //mersenne_twister_engine
  mt19937 generator (seed);  
   
  //use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

1445431990 is a random number between 0 and 4294967295

4. ranlux24_base: It is Ranlux 24 base generator. It’s a subtract-with-carry pseudo-random generator of 24-bit numbers, generally used as the base engine for the ranlux24 generator.

  • operator(): It returns a new random number.
    The function changes the internal state by calling its transition algorithm which applies a subtract-with-carry operation on the element.
  • max: It returns the maximum value given by operator().
  • min: It returns the minimum value given by operator().

C++




// C++ program to illustrate 
// the use of operator(),min and max
// in ranlux24_base
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
//Driver program
int main ()
{
       
  // finds the time between the system clock
  //(present time) and clock's epoch      
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
  subtract_with_carry_engine<unsigned,24,10,24> generator (seed);
   
  //use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

7275352 is a random number between 0 and 16777215

Similar format is applicable for the other examples.

IV. Engine Adaptors

1. discard_block_engine: It is an engine adaptor class template that adapts a pseudo-random number generator Engine type by using only ‘r’ elements of each block of ‘p’ elements from the sequence it produces, discarding the rest.
The adaptor keeps an internal count of how many elements have been produced in the current block.

The standard generators ranlux24 and ranlux48 adapt a subtract_with_carry_engine using this adaptor.

  • operator(): It returns a new random number.
  • max: It returns the maximum value given by operator().
  • min: It returns the minimum value given by operator().

C++




// C++ program to illustrate
// the use of operator(),min and max
// in the discard_block_engine
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
//Driver program
int main ()
{
       
  // finds the time between the system clock
  //(present time) and clock's epoch   
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
   
  // ranlux24 is a standard instantiation 
  //of discard_block_engine:
  ranlux24 generator (seed);
   
  //use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

8132325 is a random number between 0 and 16777215

2. independent_bits_engine: It is an engine adaptor class template that adapts a pseudo-random number generator Engine type to produce random numbers with a specific number of bits (w).

  • operator(): It returns a new random number.
    The engine’s transition algorithm invokes the base engines’s operator() member as many times as needed to obtain enough significant bits to construct a random value.
  • max: It returns the maximum value given by operator().
  • min: It returns the minimum value given by operator().

C++




// C++ program to illustrate
// the use of operator(),min and max
// in independent_bits_engine
#include <iostream>
#include <chrono>
   
// It imports the symbol names in 
// std namespace and possibly in Global namespace.
#include <cstdint>
#include <random>
using namespace std;
   
//Driver program
int main ()
{
       
  // finds the time between the system clock
  //(present time) and clock's epoch    
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
   
  //use of independent_bits_engine
  independent_bits_engine<mt19937,64,uint_fast64_t> generator (seed);
   
  //use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

13551674127875514537 is a random number between 0 and 184467

3. shuffle_order_engine: It is an engine adaptor class template that adapts a pseudo-random number generator Engine type so that the numbers are delivered in a different sequence.
The object keeps a buffer of k generated numbers internally, and when requested, returns a randomly selected number within the buffer, replacing it with a value obtained from its base engine.

  • operator(): It returns a new random number.
    The engine’s transition algorithm picks a value in the internal table (which is returned by the function) and replaces it with a new value obtained from its base engine.
  • max: It returns the maximum value given by operator().
  • min: It returns the minimum value given by operator().

C++




// C++ program to illustrate
// the use of operator(),min and max
// in shuffle_order_engine
#include <iostream>
#include <chrono>
#include <random>
using namespace std;
   
int main ()
{
       
  // finds the time between the system clock
  //(present time) and clock's epoch    
  unsigned seed = chrono::system_clock::now().time_since_epoch().count();
   
  // ranlux24 is a standard instantiation
  // of discard_block_engine:
  ranlux24 generator (seed);
   
  //use of operator()
  cout << generator() << " is a random number between ";
     
  //use of max and min
  cout << generator.min() << " and " << generator.max();
   
  return 0;
}


Output:

9213395 is a random number between 0 and 16777215


Last Updated : 20 Apr, 2022
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads