std::uniform_int_distribution

C++ Reference
Language Concepts Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Numerics library
Pseudo-random number generation
Engines and engine adaptors linear_congruential_engine (C++11) mersenne_twister_engine (C++11) subtract_with_carry_engine (C++11) discard_block_engine (C++11) independent_bits_engine (C++11) shuffle_order_engine (C++11) Generators random_device (C++11) Distributions Uniform distributions uniform_int_distribution (C++11) uniform_real_distribution (C++11) generate_canonical (C++11) Bernoulli distributions bernoulli_distribution (C++11) binomial_distribution (C++11) negative_binomial_distribution (C++11) geometric_distribution (C++11) Poisson distributions poisson_distribution (C++11) exponential_distribution (C++11) gamma_distribution (C++11) weibull_distribution (C++11) extreme_value_distribution (C++11) Normal distributions normal_distribution (C++11) lognormal_distribution (C++11) chi_squared_distribution (C++11) cauchy_distribution (C++11) fisher_f_distribution (C++11) student_t_distribution (C++11) Sampling distributions discrete_distribution (C++11) piecewise_constant_distribution (C++11) piecewise_linear_distribution (C++11) Seed Sequences seed_seq (C++11) C library rand srand RAND_MAX
std::uniform_int_distribution
Member functions uniform_int_distribution::uniform_int_distribution uniform_int_distribution::reset Generation uniform_int_distribution::operator() Characteristics uniform_int_distribution::a uniform_int_distribution::b uniform_int_distribution::param uniform_int_distribution::min uniform_int_distribution::max Non-member functions operator== operator!= operator<< operator>>

Defined in header <random>
template< class IntType = int > class uniform_int_distribution;		(since C++11)

Produces random integer values i, uniformly distributed on the closed interval [a, b], that is, distributed according to the discrete probability function

P(i|a,b) =

1

b − a + 1

.

Member types

Member type	Definition
result_type	IntType
param_type	the type of the parameter set, unspecified

Member functions

(constructor)	constructs new distribution (public member function)
reset	resets the internal state of the distribution (public member function)
Generation
operator()	generates the next random number in the distribution (public member function)
Characteristics
a	returns the a distribution parameter (minimum value) (public member function)
b	returns the b distribution parameter (maximum value) (public member function)
param	gets or sets the distribution parameter object (public member function)
min	returns the minimum potentially generated value (public member function)
max	returns the maximum potentially generated value (public member function)

Non-member functions

operator== operator!=	compares two distribution objects (function)
operator<< operator>>	performs stream input and output on pseudo-random number distribution (function)

Example

This program simulates throwing 6-sided dice.

#include <random>
#include <iostream>
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    std::uniform_int_distribution<> dis(1, 6);
    for(int n=0; n<10; ++n)
        std::cout << dis(gen) << ' ';
    std::cout << '\n';
}

Output:

1 1 6 5 2 2 5 5 6 2