Namespaces
Variants

std:: piecewise_constant_distribution

From cppreference.net
Definiert im Header <random>
template < class RealType = double >
class piecewise_constant_distribution ;
(seit C++11)

std::piecewise_constant_distribution erzeugt zufällige Gleitkommazahlen, die innerhalb jedes der mehreren Teilintervalle [b i , b i+1 ) gleichmäßig verteilt sind, wobei jedes sein eigenes Gewicht w i besitzt. Die Menge der Intervallgrenzen und die Menge der Gewichte sind die Parameter dieser Verteilung.

The probability density for any b i ≤ x <b i+1 is
w i
S (b i+1 - b i )
, where S is the sum of all weights.

std::piecewise_constant_distribution erfüllt alle Anforderungen von RandomNumberDistribution .

Inhaltsverzeichnis

Template-Parameter

RealType - Der vom Generator erzeugte Ergebnistyp. Der Effekt ist undefiniert, falls dies nicht einer von float , double , oder long double ist.

Mitgliedertypen

Mitgliedertyp Definition
result_type (C++11) RealType
param_type (C++11) der Typ des Parametersatzes, siehe RandomNumberDistribution .

Memberfunktionen

Konstruiert eine neue Verteilung
(öffentliche Elementfunktion)
(C++11)
Setzt den internen Zustand der Verteilung zurück
(öffentliche Elementfunktion)
Erzeugung
(C++11)
Erzeugt die nächste Zufallszahl in der Verteilung
(öffentliche Elementfunktion)
Eigenschaften
Gibt die Verteilungsparameter zurück
(öffentliche Elementfunktion)
(C++11)
Ruft das Verteilungsparameterobjekt ab oder legt es fest
(öffentliche Elementfunktion)
(C++11)
Gibt den minimal möglichen generierten Wert zurück
(öffentliche Elementfunktion)
(C++11)
Gibt den maximal möglichen generierten Wert zurück
(öffentliche Elementfunktion)

Nicht-Member-Funktionen

(C++11) (C++11) (entfernt in C++20)
vergleicht zwei Verteilungsobjekte
(Funktion)
führt Stream-Eingabe und -Ausgabe auf Pseudozufallszahlenverteilung durch
(Funktionstemplate)

Beispiel

#include <iostream>
#include <map>
#include <random>
#include <string>
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    // 50% der Zeit, generiere eine Zufallszahl zwischen 0 und 1
    // 50% der Zeit, generiere eine Zufallszahl zwischen 10 und 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';
}

Mögliche Ausgabe:

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

Referenzen

  • C++23-Standard (ISO/IEC 14882:2024):
  • 28.5.9.6.2 Klassentemplate piecewise_constant_distribution [rand.dist.samp.pconst] (S: 1421-1422)
  • C++20-Standard (ISO/IEC 14882:2020):
  • 29.6.9.6.2 Klassentemplate piecewise_constant_distribution [rand.dist.samp.pconst] (S: 1207-1208)
  • C++17-Standard (ISO/IEC 14882:2017):
  • 29.6.8.6.2 Klassentemplate piecewise_constant_distribution [rand.dist.samp.pconst] (S: 1098-1100)
  • C++14 Standard (ISO/IEC 14882:2014):
  • 26.5.8.6.2 Klassentemplate piecewise_constant_distribution [rand.dist.samp.pconst] (S: 962-964)
  • C++11-Standard (ISO/IEC 14882:2011):
  • 26.5.8.6.2 Klassentemplate piecewise_constant_distribution [rand.dist.samp.pconst] (S: 955-957)