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 или longdouble.

Типы-члены

Тип-член	Определение
`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:2024):

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/cpp/numeric/random/piecewise_constant_distribution