| Common mathematical functions | |||||||||||||||||||||||||||||||
| 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) | |||||||||||||||||||||||||||||||
| Complex numbers | |||||||||||||||||||||||||||||||
Numeric array (valarray) | |||||||||||||||||||||||||||||||
| Pseudo-random number generation | |||||||||||||||||||||||||||||||
| Bit manipulation(C++20) | |||||||||||||||||||||||||||||||
| Saturation arithmetic(C++26) | |||||||||||||||||||||||||||||||
| Factor operations | |||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||
| Interpolations | |||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||
| Generic numeric operations | |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
| C-style checked integer arithmetic | |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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) | |
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
| 1 |
| b − a + 1 |
std::uniform_int_distribution satisfies all requirements ofRandomNumberDistribution.
Contents |
| IntType | - | The result type generated by the generator. The effect is undefined if this is not one ofshort,int,long,longlong,unsignedshort,unsignedint,unsignedlong, orunsignedlonglong. |
| Member type | Definition |
result_type(C++11) | IntType |
param_type(C++11) | the type of the parameter set, seeRandomNumberDistribution. |
(C++11) | constructs new distribution (public member function)[edit] |
(C++11) | resets the internal state of the distribution (public member function)[edit] |
Generation | |
(C++11) | generates the next random number in the distribution (public member function)[edit] |
Characteristics | |
(C++11) | returns the distribution parameters (public member function)[edit] |
(C++11) | gets or sets the distribution parameter object (public member function)[edit] |
(C++11) | returns the minimum potentially generated value (public member function)[edit] |
(C++11) | returns the maximum potentially generated value (public member function)[edit] |
(C++11)(C++11)(removed in C++20) | compares two distribution objects (function)[edit] |
(C++11) | performs stream input and output on pseudo-random number distribution (function template)[edit] |
This program simulates throwing 6-sideddice.
#include <iostream>#include <random> int main(){std::random_device rd;// a seed source for the random number enginestd::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