Rand

Rand 是一个 Rust 随机数生成库，具有以下特点：

• 通过 Rng、SliceRandom 和 IteratorRandom 特性轻松生成和使用随机值
• 通过 getrandom 包 安全地播种，并通过 thread_rng 快速、方便地生成
• 基于 rand_core 的模块化设计（见书籍）
• 最佳类别的加密和非加密生成器的快速实现
• 灵活的 distributions 模块
• 通过我们自己的 rand_distr 和 statrs 提供的大量随机数分布的采样器
• 可移植且可重现的输出
• #[no_std] 兼容性（部分）
• 许多 性能优化

也值得指出的是，rand 不是什么

• 小。大多数低级包都很小，但更高层的 rand 和 rand_distr 每个都包含很多功能。
• 简单（实现）。我们非常重视正确性、速度和灵活性，但不是简单性。如果您喜欢小型且简单的库，有其他选择，包括 fastrand 和 oorandom。
• 慢。我们认真对待性能，同时也考虑了新分布的设置时间、常用参数和当前采样器的参数。

文档

• Rust Rand 书籍
• API 参考（master 分支）
• API 参考（docs.rs）

用法

将此添加到您的 Cargo.toml

[dependencies]
rand = "0.8.5"

要开始使用Rand，请参阅《Rand图书》。

版本

Rand已经成熟（适用于通用用途，具有不频繁的破坏性发布，最小化破坏）但尚未达到1.0版本。我们与固定版本的Rust编译器保持兼容性（见下文）。

当前Rand版本有

• Version 0.7于2019年6月发布，将大多数非均匀分布移动到外部crate中，将from_entropy移动到SeedableRng，以及许多小的更改和修复。
• Version 0.8于2020年12月发布，进行了许多小的更改。

有关发布的详细变更日志可供查阅。

当升级到下一个次要系列（特别是0.4 → 0.5）时，我们建议阅读升级指南。

Rand尚未达到1.0，这意味着未来可能会出现一些破坏性变更（SemVer允许每个0.x.0版本包含破坏性变更），但被视为成熟：破坏性变更最小化，破坏性发布不频繁。

Rand库之间存在相互依赖关系，并使用semver技巧以使特性在不同crate版本之间兼容。（这对于RngCore和SeedableRng尤为重要。）因此，一些crate发布是兼容性垫片，取决于下一个lib版本（例如，rand_core版本0.2.2和0.3.1）。这意味着，例如，rand_core_0_4_0::SeedableRng和rand_core_0_3_0::SeedableRng是不同的、不兼容的特性，这可能导致构建错误。通常，运行cargo update足以修复任何问题。