std::uniform_int_distribution
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Numerics library
Mathematical special functions (C++17)
Mathematical constants (C++20)
Basic linear algebra algorithms (C++26)
Data-parallel types (SIMD) (C++26)
Floating-point environment (C++11)
Bit manipulation (C++20)
Saturation arithmetic (C++26)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
Pseudo-random number generation
(C++20)
(C++11)
(C++11)
(C++11)
(C++26)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++26)
uniform_int_distribution
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
std::uniform_int_distribution
Member functions
Generation
Characteristics
Non-member functions
(C++11)(C++11)(until C++20)
(C++11)(C++11)
Defined in header
<random>
template< class IntType = int >
class uniform_int_distribution;
(since C++11)
class uniform_int_distribution;
Produces random integer values \(\small i\)i, uniformly distributed on the closed interval \(\small[a, b]\)[a, b], that is, distributed according to the discrete probability function
- \({\small P(i|a,b) =}\frac{1}{b - a + 1}\)P(i|a,b) = 1b − a + 1.
std::uniform_int_distribution satisfies all requirements of RandomNumberDistribution.
Contents
[edit] Template parameters
IntType
-
The result type generated by the generator. The effect is undefined if this is not one of short, int, long, long long, unsigned short, unsigned int, unsigned long, or unsigned long long.
[edit] Member types
Member type
Definition
result_type (C++11)
IntType
[edit] Member functions
Generation
Characteristics
[edit] Non-member functions
(C++11)
(function template) [edit]
[edit] Example
This program simulates throwing 6-sided dice.
Run this code
#include <iostream> #include <random> int main() { std::random_device rd; // a seed source for the random number engine std::mt19937 gen(rd()); // mersenne_twister_engine seeded with rd() std::uniform_int_distribution<> distrib(1, 6); // Use distrib to transform the random unsigned int // generated by gen into an int in [1, 6] for (int n = 0; n != 10; ++n) std::cout << distrib(gen) << ' '; std::cout << '\n'; }
Possible output:
1 1 6 5 2 2 5 5 6 2