目录

14. 枚举

学习目标

14.1 为什么需要枚举

枚举用于描述一个值可能的几种形态。例如,IP 地址可以是 IPv4 或 IPv6:

snippet.rust
enum IpAddrKind {
    V4,
    V6,
}
 
fn main() {
    let four = IpAddrKind::V4;
    let six = IpAddrKind::V6;
}

IpAddrKind::V4 和 IpAddrKind::V6 都是 IpAddrKind 类型的值。

14.2 枚举携带数据

Rust 的枚举变体可以携带数据,这是它非常强大的地方:

snippet.rust
enum IpAddr {
    V4(String),
    V6(String),
}
 
fn main() {
    let home = IpAddr::V4(String::from("127.0.0.1"));
    let loopback = IpAddr::V6(String::from("::1"));
}

不同变体可以携带不同类型:

snippet.rust
enum IpAddr {
    V4(u8, u8, u8, u8),
    V6(String),
}
 
fn main() {
    let home = IpAddr::V4(127, 0, 0, 1);
    let loopback = IpAddr::V6(String::from("::1"));
}

14.3 枚举与结构体

有些情况既可以用枚举也可以用结构体,但枚举更适合表达“要么是 A,要么是 B”的语义:

snippet.rust
enum Message {
    Quit,
    Move { x: i32, y: i32 },
    Write(String),
    ChangeColor(i32, i32, i32),
}

上面的 Message 枚举有四个变体: - Quit:没有数据。 - Move:携带命名字段,类似结构体。 - Write:携带一个 String。 - ChangeColor:携带三个 i32。

14.4 为枚举定义方法

和结构体一样,枚举也可以用 impl 定义方法:

snippet.rust
enum Message {
    Quit,
    Move { x: i32, y: i32 },
    Write(String),
}
 
impl Message {
    fn call(&self) {
        match self {
            Message::Quit => println!("Quit"),
            Message::Move { x, y } => println!("Move to x: {}, y: {}", x, y),
            Message::Write(text) => println!("Write: {}", text),
        }
    }
}
 
fn main() {
    let m = Message::Write(String::from("hello"));
    m.call();
}
这里用到了 `match`,会在下一节重点讲解。

## 14.5 枚举在标准库中的身影

Rust 标准库中大量使用枚举。例如:

14.6 单元枚举

如果所有变体都不携带数据,枚举类似于其他语言中的枚举常量:

snippet.rust
enum Direction {
    North,
    South,
    East,
    West,
}

这种枚举常常与 match 配合使用。

14.7 小结

特性 枚举 结构体
描述“多选一” 非常适合 不适合
携带数据 每个变体可独立携带 所有字段同时存在
定义方法 支持 impl 支持 impl
常见用途 状态、命令、选项、错误 复合数据

14.8 思考题

  1. 设计一个枚举 TrafficLight,包含红、黄、绿三种状态,并实现一个返回当前灯持续时间的方法。
  2. 枚举变体 Message::Move { x: i32, y: i32 } 和结构体 Move { x: i32, y: i32 } 有什么区别?
  3. 下面代码能否编译?为什么?
snippet.rust
enum Coin {
    Penny,
    Nickel,
    Dime,
    Quarter(String),
}
 
fn main() {
    let c = Coin::Quarter(String::from("Alaska"));
    let Coin::Quarter(state) = c;
    println!("{}", state);
}