C++ 命名要求： UniformRandomBitGenerator (C++11 起)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 命名要求

基本 DefaultConstructible（可預設構造） MoveConstructible（可移動構造） (C++11) CopyConstructible（可複製構造） CopyAssignable（可複製賦值） MoveAssignable（可移動賦值） (C++11) Destructible（可析構） 型別屬性 ScalarType（標量型別） PODType（POD型別） TriviallyCopyable（可平凡複製） (C++11) TrivialType（平凡型別） (C++11) StandardLayoutType（標準佈局型別） (C++11)   ImplicitLifetimeType（隱式生命週期型別） 全庫範圍 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)   容器元素 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) 流 I/O FormattedInputFunction（格式化輸入函式） UnformattedInputFunction（非格式化輸入函式） FormattedOutputFunction（格式化輸出函式） UnformattedOutputFunction（非格式化輸出函式） 格式化器 BasicFormatter（基本格式化器） (C++20) Formatter (C++20)

隨機數 SeedSequence（種子序列） (C++11) RandomNumberEngine（隨機數引擎） (C++11) RandomNumberDistribution（隨機數分佈） (C++11) UniformRandomBitGenerator（均勻隨機位元生成器） (C++11) RandomNumberEngineAdaptor（隨機數引擎介面卡） (C++11) 併發 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) Ranges RangeAdaptorObject（範圍介面卡物件） (C++20) RangeAdaptorClosureObject（範圍介面卡閉包物件） (C++20) 多維檢視 LayoutMapping（佈局對映） (C++23) LayoutMappingPolicy（佈局對映策略） (C++23) AccessorPolicy (C++23) 其他 CharTraits（字元特性） RegexTraits（正則表示式特性） (C++11)   BitmaskType（位掩碼型別） LiteralType（字面量型別） (C++11) NumericType（數值型別） UnaryTypeTrait（一元型別特性） (C++11) BinaryTypeTrait（二元型別特性） (C++11) TransformationTrait（轉換特性） (C++11) Clock（時鐘） (C++11) TrivialClock（平凡時鐘） (C++11)

 

一個均勻隨機位生成器是一個函式物件，它返回無符號整數值，使得每個可能結果範圍內的值（理想情況下）具有相等的機率。

均勻隨機位生成器不打算用作隨機數生成器：它們用作隨機位的來源（為提高效率而批次生成）。任何均勻隨機位生成器都可以插入任何隨機數分佈中，以獲得一個隨機數（形式上，一個隨機變數）。

要求

型別 G 滿足 UniformRandomBitGenerator，如果

給定型別 G 的值 g，則滿足所有以下條件： G::result_type 是有效的，並表示一個無符號整數型別。 以下表達式必須有效並具有其指定的效果

(C++20 前)

表示式	型別	要求
G::min()	G::result_type	產生 G 的 operator() 可能返回的最小值。 結果值嚴格小於 G::max()。 表示式必須是常量表達式。
G::max()	G::result_type	產生 G 的 operator() 可能返回的最大值。 結果值嚴格大於 G::min()。 表示式必須是常量表達式。
g()	G::result_type	返回閉區間 [G::min(), G::max()] 中的值。 具有均攤常數複雜度。

滿足所有以下條件： G 建模 uniform_random_bit_generator。 std::invoke_result_t<G&> 是一個無符號整數型別。 G 提供一個巢狀的 typedef 名稱 result_type，它表示與 std::invoke_result_t<G&> 相同的型別。

(C++20 起)

注意

所有 RandomNumberEngine 都滿足此要求。

標準庫

以下標準庫設施期望一個 UniformRandomBitGenerator 型別。

random_shuffleshuffle (C++17 前)(C++11)	隨機地重排一個範圍中的元素 (函式模板)
sample (C++17)	從一個序列中選擇 N 個隨機元素 (函式模板)
generate_canonical (C++11)	均勻分佈給定精度的實值於 [​0​, 1) (函式模板)
uniform_int_distribution (C++11)	產生在給定範圍內均勻分佈的整數值 (類模板)
uniform_real_distribution (C++11)	產生在給定範圍內均勻分佈的實數值 (類模板)
所有其他隨機數分佈

以下標準庫設施滿足 UniformRandomBitGenerator，而不需要額外滿足 RandomNumberEngine

random_device (C++11)

使用硬體熵源的非確定性隨機數生成器 (類)

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 2154 (P0898R3)	C++11	不清楚 G::min() 和 G::max() 是否要求是常量表達式	需要

另見

uniform_random_bit_generator (C++20)

指定型別是否符合統一隨機位生成器 (概念)