C++ benannte Anforderungen: UniformRandomBitGenerator (seit C++11)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

C++ benannte Anforderungen

Basis DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible Typeneigenschaften ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType Bibliothekweit BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

Container Container ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   Container-Element DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) Iterator LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) Stream-I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction Formatters BasicFormatter (C++20) Formatter (C++20)

Zufallszahlen SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) Concurrency BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) Bereiche (Ranges) RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) Mehrdimensionale Ansicht LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) Sonstiges CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

Ein uniformer Zufallsbitgenerator ist ein Funktions-Objekt, das vorzeichenlose Ganzzahlwerte zurückgibt, sodass jeder Wert im Bereich möglicher Ergebnisse (idealerweise) die gleiche Wahrscheinlichkeit hat.

Uniforme Zufallsbitgeneratoren sind nicht dazu gedacht, als Zufallszahlengeneratoren verwendet zu werden: Sie werden als Quelle für Zufallsbits verwendet (die aus Effizienzgründen in großen Mengen generiert werden). Jeder uniforme Zufallsbitgenerator kann in jede Zufallszahlendistribution eingesetzt werden, um eine Zufallszahl (formal eine Zufallsvariante) zu erhalten.

Anforderungen

Der Typ G erfüllt die Anforderung UniformRandomBitGenerator, wenn

Gegeben sei G g, ein Wert vom Typ G. Alle folgenden Bedingungen sind erfüllt: G::result_type ist gültig und bezeichnet einen vorzeichenlosen Ganzzahltyp. Die folgenden Ausdrücke müssen gültig sein und ihre angegebenen Effekte haben

(bis C++20)

Ausdruck	Typ	Anforderungen
G::min()	G::result_type	Liefert den kleinsten Wert, den der Operator() von G zurückgeben kann.  Der Ergebniswert ist strikt kleiner als G::max(). Der Ausdruck muss ein konstanter Ausdruck sein.
G::max()	G::result_type	Liefert den größten Wert, den der Operator() von G zurückgeben kann. Der Ergebniswert ist strikt größer als G::min(). Der Ausdruck muss ein konstanter Ausdruck sein.
g()	G::result_type	Gibt einen Wert im geschlossenen Intervall [G::min(), G::max()] zurück. Hat amortisierte konstante Komplexität.

Alle folgenden Bedingungen sind erfüllt G modelliert uniform_random_bit_generator. std::invoke_result_t<G&> ist ein vorzeichenloser Ganzzahltyp. G stellt einen verschachtelten typedef-Namen result_type bereit, der denselben Typ wie std::invoke_result_t<G&> bezeichnet.

(seit C++20)

Hinweise

Alle RandomNumberEngines erfüllen diese Anforderung.

Standardbibliothek

Die folgenden Standardbibliothekseinrichtungen erwarten einen Typ UniformRandomBitGenerator.

random_shuffleshuffle (bis C++17)(C++11)	Ordnet Elemente in einem Bereich zufällig neu an (Funktionstemplate)
sample (C++17)	Wählt N zufällige Elemente aus einer Sequenz aus (Funktionstemplate)
generate_canonical (C++11)	verteilt reelle Werte mit gegebener Genauigkeit gleichmäßig über [​0​, 1) (Funktionstemplate)
uniform_int_distribution (C++11)	erzeugt ganzzahlige Werte, die gleichmäßig über einen Bereich verteilt sind (Klassenschablone)
uniform_real_distribution (C++11)	erzeugt reelle Werte, die gleichmäßig über einen Bereich verteilt sind (Klassenschablone)
alle anderen Zufallszahlendistributionen

Die folgenden Standardbibliothekseinrichtungen erfüllen UniformRandomBitGenerator, ohne zusätzlich RandomNumberEngine zu erfüllen.

random_device (C++11)

nicht-deterministischer Zufallszahlengenerator mit Hardware-Entropiequelle (Klasse)

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 2154 (P0898R3)	C++11	war unklar, ob G::min() und G::max() konstante Ausdrücke sein müssen	Gefordert

Siehe auch

uniform_random_bit_generator (C++20)

spezifiziert, dass ein Typ als gleichmäßiger Zufallsbitgenerator qualifiziert ist (Konzept)