uniform_real_distribution 類別
在內含-專有的輸出範圍中產生統一 (每個值都有同等可能性) 浮點分佈。
語法
template<class RealType = double>
class uniform_real_distribution {
public:
// types
typedef RealType result_type;
struct param_type;
// constructors and reset functions
explicit uniform_real_distribution(
result_type a = 0.0, result_type b = 1.0);
explicit uniform_real_distribution(const param_type& parm);
void reset();
// generating functions
template <class URNG>
result_type operator()(URNG& gen);
template <class URNG>
result_type operator()(URNG& gen, const param_type& parm);
// property functions
result_type a() const;
result_type b() const;
param_type param() const;
void param(const param_type& parm);
result_type min() const;
result_type max() const;
};
參數
RealType
浮點結果類型,預設值為 double
。 如需可能的類型,請參閱 <隨機>。
備註
類別範本描述包容性獨佔分佈,其會產生具有分佈之使用者指定整數浮點類型的值,讓每個值都同樣可能。 下表提供各個成員的文章連結。
uniform_real_distribution
param_type|
屬性成員 a()
會傳回目前儲存的分佈下限,而 b()
會傳回目前儲存的上限。 對於這個散發類別,這些最小值和最大值與 common 屬性函 min()
式所傳回的值相同,且 max()
如 <隨機> 主題中所述。
屬性成員 param()
會設定或傳回 param_type
預存分佈參數套件。
min()
和 max()
成員函式會分別傳回最小可能結果和最大可能結果。
reset()
成員函式會捨棄任何快取的值,讓下個針對 operator()
呼叫的結果不是取決於呼叫之前取自引擎的任何值。
operator()
成員函式會根據 URNG 引擎傳回下一個產生的值,無論是從目前的參數封裝或是指定的參數封裝。
如需散發類別及其成員的詳細資訊,請參閱 <隨機>。
範例
// compile with: /EHsc /W4
#include <random>
#include <iostream>
#include <iomanip>
#include <string>
#include <map>
void test(const double a, const double b, const int s) {
// uncomment to use a non-deterministic seed
// std::random_device rd;
// std::mt19937 gen(rd());
std::mt19937 gen(1729);
std::uniform_real_distribution<> distr(a,b);
std::cout << "lower bound == " << distr.a() << std::endl;
std::cout << "upper bound == " << distr.b() << std::endl;
// generate the distribution as a histogram
std::map<double, int> histogram;
for (int i = 0; i < s; ++i) {
++histogram[distr(gen)];
}
// print results
std::cout << "Distribution for " << s << " samples:" << std::endl;
int counter = 0;
for (const auto& elem : histogram) {
std::cout << std::fixed << std::setw(11) << ++counter << ": "
<< std::setprecision(10) << elem.first << std::endl;
}
std::cout << std::endl;
}
int main()
{
double a_dist = 1.0;
double b_dist = 1.5;
int samples = 10;
std::cout << "Use CTRL-Z to bypass data entry and run using default values." << std::endl;
std::cout << "Enter a floating point value for the lower bound of the distribution: ";
std::cin >> a_dist;
std::cout << "Enter a floating point value for the upper bound of the distribution: ";
std::cin >> b_dist;
std::cout << "Enter an integer value for the sample count: ";
std::cin >> samples;
test(a_dist, b_dist, samples);
}
Use CTRL-Z to bypass data entry and run using default values.
Enter a floating point value for the lower bound of the distribution: 0
Enter a floating point value for the upper bound of the distribution: 1
Enter an integer value for the sample count: 10
lower bound == 0
upper bound == 1
Distribution for 10 samples:
1: 0.0288609485
2: 0.2007994386
3: 0.3027480117
4: 0.4124758695
5: 0.4413777133
6: 0.4846447405
7: 0.6225745916
8: 0.6880935217
9: 0.7541936723
10: 0.8795716566
需求
標頭:<random>
命名空間:std
uniform_real_distribution::uniform_real_distribution
建構分佈。
explicit uniform_real_distribution(result_type a = 0.0, result_type b = 1.0);
explicit uniform_real_distribution(const param_type& parm);
參數
a
隨機值的下限 (內含)。
b
隨機值的上限 (專有)。
parm
用來建構分佈的 param_type
結構。
備註
前置條件:a < b
第一個建構函式會建構一個物件,其儲存的值會保留 值 a,而儲存的 b 值則保留值 b。
第二個建構函式會建構預存參數是從 parm 初始化而來的物件。 您可以呼叫 param()
成員函式,取得及設定現有分佈的目前參數。
uniform_real_distribution::param_type
儲存分佈的所有參數。
struct param_type {
typedef uniform_real_distribution<result_type> distribution_type;
param_type(result_type a = 0.0, result_type b = 1.0);
result_type a() const;
result_type b() const;
bool operator==(const param_type& right) const;
bool operator!=(const param_type& right) const;
};
參數
a
隨機值的下限 (內含)。
b
隨機值的上限 (專有)。
right
要與這個項目比較的 param_type
物件。
備註
前置條件:a < b
此結構可在具現化時傳遞至分佈的類別建構函式,傳遞至 param()
成員函式可設定現有分佈之儲存的參數,傳遞至 operator()
可用於取代儲存的參數。