1 快速入门

Sun, 23 Aug 2026 16:44:00 +0800

原文链接: https://rust-random.github.io/book/quick-start.html

下面列出一个简短示例。更多内容请参阅 API 文档或指南。

让我们从一个示例开始：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


// 从 prelude 导入常用项：
use rand::prelude::*;

fn main() {
 // 我们可以立即使用 random()。它可以生成多种常见类型的值：
 let x: u8 = rand::random();
 println!("{}", x);

 if rand::random() { // 生成一个布尔值
 println!("Heads!");
 }

 // 如果我们想更明确一些（也更高效一点），可以
 // 获取线程局部生成器的句柄：
 let mut rng = rand::rng();
 if rng.random() { // 随机布尔值
 let x: f64 = rng.random(); // [0, 1) 范围内的随机数
 let y = rng.random_range(-10.0..10.0);
 println!("x is: {}", x);
 println!("y is: {}", y);
 }

 println!("Dice roll: {}", rng.random_range(1..=6));
 println!("Number from 0 to 9: {}", rng.random_range(0..10));
 
 // 有时直接使用分布会很有用：
 let distr = rand::distr::Uniform::new_inclusive(1, 100).unwrap();
 let mut nums = [0i32; 3];
 for x in &mut nums {
 *x = rng.sample(distr);
 }
 println!("Some numbers: {:?}", nums);

 // 我们也可以与迭代器和切片交互：
 let arrows_iter = "➡⬈⬆⬉⬅⬋⬇⬊".chars();
 println!("Lets go in this direction: {}", arrows_iter.choose(&mut rng).unwrap());
 let mut nums = [1, 2, 3, 4, 5];
 nums.shuffle(&mut rng);
 println!("I shuffled my {:?}", nums);
}

你可能注意到的第一件事是我们从 prelude 导入了所有内容。这是使用 rand 的简便方式，与标准库的 prelude 类似，只导入最常用的项。如果你不想使用 prelude，请记得导入 Rng trait！

The Rust Rand Book on 编程那些事儿

1 快速入门