std::piecewise_constant_distribution

Определено в заголовке `<random>`
template< class RealType = double > class piecewise_constant_distribution;		(с C++11)

std::piecewise_constant_distribution генерирует случайные числа с плавающей точкой, равномерно распределённые в каждом из нескольких подынтервалов [b_i, b_i+1), каждый со своим весом w_i. Набор границ интервалов и набор весов являются параметрами этого распределения. Вероятность плотности для любого b_i ≤ x <b_i+1 равна wi/S (bi+1 - bi), где S — сумма всех весов.

std::piecewise_constant_distribution удовлетворяет всем требованиям RandomNumberDistribution.

Параметры шаблона

RealType - Тип результата, генерируемый генератором. Эффект не определён, если это не один из float, double, или long double.

Типы членов

Тип члена	Определение
`result_type` (C++11)	RealType
`param_type` (C++11)	тип набора параметров, см. RandomNumberDistribution.

Члены-функции

(конструктор) (C++11)	создаёт новое распределение (публичный член-функция)
reset (C++11)	сбрасывает внутреннее состояние распределения (публичный член-функция)
Генерирование
operator() (C++11)	генерирует следующее случайное число в распределении (публичный член-функция)
Характеристики
intervalsdensities	возвращает параметры распределения (публичный член-функция)
param (C++11)	получает или задаёт объект параметра распределения (публичный член-функция)
min (C++11)	возвращает минимальное потенциально генерируемое значение (публичный член-функция)
max (C++11)	возвращает максимальное потенциально генерируемое значение (публичный член-функция)

Внешние функции

operator==operator!= (C++11)(C++11)(удалено в C++20)	сравнивает два объекта распределения (функция)
operator<<operator>> (C++11)	выполняет ввод и вывод потока на псевдослучайное распределение (шаблон функции)

Пример

#include <iostream>
#include <map>
#include <random>
#include <string>
 
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    // 50% of the time, generate a random number between 0 and 1
    // 50% of the time, generate a random number between 10 and 15
    std::vector<double> i {0, 1, 10, 15};
    std::vector<double> w {1, 0, 1};
    std::piecewise_constant_distribution<> d(i.begin(), i.end(), w.begin());
 
    std::map<int, int> hist;
    for (int n {}; n < 1e4; ++n)
        ++hist[d(gen)];
 
    for (std::cout << std::hex << std::uppercase; auto [x, y] : hist)
        std::cout << x << ' ' << std::string(y / 100, '*') << '\n';
}

Возможный вывод:

0 **************************************************
A **********
B *********
C *********
D **********
E *********

Ссылки

Стандарт C++23 (ISO/IEC 14882:2023):

28.5.9.6.2 Класс-шаблон piecewise_constant_distribution [rand.dist.samp.pconst] (с. 1421-1422)

Стандарт C++20 (ISO/IEC 14882:2020):

29.6.9.6.2 Класс-шаблон piecewise_constant_distribution [rand.dist.samp.pconst] (с. 1207-1208)

Стандарт C++17 (ISO/IEC 14882:2017):

29.6.8.6.2 Класс-шаблон piecewise_constant_distribution [rand.dist.samp.pconst] (с. 1098-1100)

Стандарт C++14 (ISO/IEC 14882:2014):

26.5.8.6.2 Класс-шаблон piecewise_constant_distribution [rand.dist.samp.pconst] (с. 962-964)

Стандарт C++11 (ISO/IEC 14882:2011):

26.5.8.6.2 Класс-шаблон piecewise_constant_distribution [rand.dist.samp.pconst] (с. 955-957)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/random/piecewise_constant_distribution