当单个变量无法完整描述一个事物时,可以用结构体把相关数据组合在一起:
struct User { username: String, email: String, sign_in_count: u64, active: bool, } fn main() { let user1 = User { email: String::from("someone@example.com"), username: String::from("someusername123"), active: true, sign_in_count: 1, }; println!("{}", user1.email); }
结构体让代码更有语义,也能避免用不相关的元组硬拼数据。
最常见的形式:
struct Rectangle { width: u32, height: u32, }
字段没有名字,只有类型:
struct Point(i32, i32); fn main() { let p = Point(10, 20); println!("x = {}, y = {}", p.0, p.1); }
元组结构体适合简单、字段含义明显的组合。
没有任何字段:
struct AlwaysEqual; fn main() { let _subject = AlwaysEqual; }
单元结构体常用于实现 trait 或作为类型标记。
基于已有实例创建新实例时,可以使用结构体更新语法:
fn main() { let user1 = User { email: String::from("old@example.com"), username: String::from("old"), active: true, sign_in_count: 1, }; let user2 = User { email: String::from("new@example.com"), ..user1 }; }
..user1 会把 user1 中剩余的字段值移动到 user2。如果某些字段没有实现 Copy,user1 将不再能使用这些字段。
结构体拥有其字段的所有权(除非字段是引用)。如果字段是 String 等堆类型,结构体实例移动时,字段也会移动:
struct User { username: String, email: String, } fn main() { let u = User { username: String::from("alice"), email: String::from("alice@example.com"), }; let name = u.username; // u.username 被移动到 name // println!("{}", u.username); // 错误 println!("{}", u.email); // 仍然有效 }
如果结构体包含引用字段,则需要显式标注生命周期(本阶段不深入,后续进阶课程会讲)。
方法是在结构体(或枚举、trait 对象)上下文中定义的函数。第一个参数是 self:
struct Rectangle { width: u32, height: u32, } impl Rectangle { fn area(&self) -> u32 { self.width * self.height } fn can_hold(&self, other: &Rectangle) -> bool { self.width > other.width && self.height > other.height } } fn main() { let rect1 = Rectangle { width: 30, height: 50 }; println!("面积为 {}", rect1.area()); }
| 形式 | 说明 |
&self | 不可变借用,只读访问,最常用 |
&mut self | 可变借用,可以修改 |
self | 获取所有权,会消耗实例 |
impl 块中不以 self 作为第一个参数的函数称为关联函数,通常用作构造器:
impl Rectangle { fn square(size: u32) -> Rectangle { Rectangle { width: size, height: size } } } fn main() { let sq = Rectangle::square(10); }
关联函数通过 :: 调用,类似于 String::from。
如果希望结构体实例能直接被打印,可以使用 #[derive(Debug)]:
#[derive(Debug)] struct Rectangle { width: u32, height: u32, } fn main() { let rect = Rectangle { width: 30, height: 50 }; println!("rect = {:?}", rect); println!("rect = {:#?}", rect); // 格式化输出 }
Debug 是常用派生 trait 之一,其他还有 Clone、Copy、PartialEq 等。
| 结构体形式 | 示例 | 使用场景 |
| 命名字段结构体 | struct User { name: String } | 复杂数据组合 |
| 元组结构体 | struct Point(i32, i32) | 简单、字段意义明确的组合 |
| 单元结构体 | struct AlwaysEqual; | 类型标记、trait 实现 |
struct Person { name: String, age: u32, } fn main() { let p = Person { name: String::from("Alice"), age: 30, }; let n = p.name; println!("{}", p.name); }
&self 和 self 有什么区别?什么时候应该使用 self?
Circle 结构体,包含半径,并实现计算面积和周长的方法。