C++ 命名需求： UniformRandomBitGenerator (自 C++11 起)

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

C++ 命名需求

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 类型属性 ScalarType PODType 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) 范围 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 起)

说明

所有 RandomNumberEngines 都满足此要求。

标准库

以下标准库设施期望 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++ 标准。

DR	应用于	发布的行为	正确的行为
LWG 2154 (P0898R3)	C++11	不清楚 G::min() 和 G::max() 是否需要是常量表达式	需要

另请参见

uniform_random_bit_generator (C++20)

指定类型是否满足统一随机位生成器 (概念)