std::discrete_distribution::discrete_distribution

From Cppreference

C++ Standard Library
Language 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::discrete_distribution
Member functions discrete_distribution::discrete_distribution discrete_distribution::reset Generation discrete_distribution::operator() Characteristics discrete_distribution::probabilities discrete_distribution::param discrete_distribution::min discrete_distribution::max Non-member functions operator== operator!= operator<< operator>>

discrete_distribution();	(1)	(since C++11)
template< class InputIterator > discrete_distribution( InputIterator first, InputIterator last );	(2)	(since C++11)
discrete_distribution( std::initializer_list<double> weights );	(3)	(since C++11)
template< class UnaryOperation > discrete_distribution( std::size_t count, double xmin, double xmax, UnaryOperation unary_op );	(4)	(since C++11)
explicit discrete_distribution( const param_type& params );	(2)	(since C++11)

Constructs a new distribution object.

1) Default constructor. Constructs the distribution with weights . This distribution will always generate ​0​.

2) Constructs the distribution with weights in the range [first, last). If first == last, the effects are the same as of the default constructor.

3) Constructs the distribution with weights in weights. Effectively calls initializer_list(weigths.begin(), weights.end()).

4) Constructs the distribution with count weights that are generated using function unary_op. Each of the weights is equal to w
i = unary_op(xmin + δ/2 + i · δ), where δ =

(xmax − xmin)

count

and i ∈ {0, ..., count−1}. xmin and xmax must be such that δ > 0. If count == 0 the effects are the same as of the default constructor.

5) Constructs the distribution with params as the distribution parameters.

[edit] Parameters

first, last	-	the range of elements defining the numbers to use as weights. The type of the elements referred by InputIterator must be convertible to double
weights	-	initializer list containing the weights
unary_op	-	unary operation function object that will be applied. The signature of the function should be equivalent to the following: Ret fun(const Type &a); The signature does not need to have const &. The type Type must be such that an object of type double can be dereferenced and then implicitly converted to Type. The type Ret must be such that an object of type double can be dereferenced and assigned a value of type Ret. ​
params	-	the distribution parameter set