Rust实战：深入理解HashMap的使用与原理-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00931/article/details/148392841

Rust实战：深入理解HashMap的使用与原理

rust-by-practice Learning Rust By Practice, narrowing the gap between beginner and skilled-dev through challenging examples, exercises and projects. 项目地址: https://gitcode.com/gh_mirrors/ru/rust-by-practice

HashMap是Rust标准库中提供的哈希表实现，它是一种非常重要的数据结构，能够以接近O(1)的时间复杂度进行数据的插入、删除和查找操作。本文将深入探讨HashMap的各种特性和使用方法。

HashMap基础特性

Rust的HashMap默认使用SipHash 1-3哈希算法，这种算法在安全性和性能之间取得了很好的平衡：

安全性：能有效抵抗HashDos攻击
性能：对于中等大小的key表现良好
实现：基于Google的SwissTable算法，性能优异

基本操作示例

让我们通过几个示例来学习HashMap的基本操作：

示例1：创建和操作HashMap

use std::collections::HashMap;

fn main() {
    let mut scores = HashMap::new();
    scores.insert("Sunface", 98);
    scores.insert("Daniel", 95);
    
    // 获取值
    let score = scores.get("Sunface");
    assert_eq!(score, Some(&98));
    
    // 检查键是否存在
    if scores.contains_key("Daniel") {
        // 通过索引访问
        let score = scores["Daniel"];
        assert_eq!(score, 95);
        scores.remove("Daniel");
    }
    
    // 遍历HashMap
    for (name, score) in &scores {
        println!("{}: {}", name, score);
    }
}

示例2：从集合创建HashMap

use std::collections::HashMap;

fn main() {
    let teams = [
        ("Chinese Team", 100),
        ("American Team", 10),
        ("France Team", 50),
    ];

    // 方法1：使用循环插入
    let mut teams_map1 = HashMap::new();
    for team in &teams {
        teams_map1.insert(team.0, team.1);
    }

    // 方法2：使用collect转换
    let teams_map2: HashMap<_, _> = teams.into_iter().collect();
    
    assert_eq!(teams_map1, teams_map2);
}

高级操作

使用entry API

entry API提供了一种更高效的方式来处理可能不存在的键：

use std::collections::HashMap;

fn main() {
    let mut player_stats = HashMap::new();
    
    // 如果键不存在则插入默认值
    player_stats.entry("health").or_insert(100);
    assert_eq!(player_stats["health"], 100);
    
    // 使用闭包计算初始值
    player_stats.entry("health").or_insert_with(|| 42);
    
    // 获取可变引用并修改值
    let health = player_stats.entry("health").or_insert(50);
    *health -= 20;
    assert_eq!(*health, 80);
}

HashMap的键类型限制

HashMap的键必须实现Eq和Hash trait。以下类型可以作为键：

基本类型：bool、整数类型等
String和&str
自定义类型（需手动或通过derive实现相关trait）

注意：浮点类型(f32/f64)不能作为键，因为浮点数的精度问题会导致哈希不一致。

自定义类型作为键示例

use std::collections::HashMap;

#[derive(Debug, Hash, Eq, PartialEq)]
struct Viking {
    name: String,
    country: String,
}

impl Viking {
    fn new(name: &str, country: &str) -> Viking {
        Viking {
            name: name.to_string(),
            country: country.to_string(),
        }
    }
}

fn main() {
    let vikings = HashMap::from([
        (Viking::new("Einar", "Norway"), 25),
        (Viking::new("Olaf", "Denmark"), 24),
    ]);
    
    for (viking, health) in &vikings {
        println!("{:?} has {} hp", viking, health);
    }
}

容量管理

HashMap提供了容量管理的方法：

use std::collections::HashMap;

fn main() {
    // 指定初始容量
    let mut map = HashMap::with_capacity(100);
    map.insert(1, 2);
    
    // 实际容量可能大于指定值
    assert!(map.capacity() >= 100);
    
    // 收缩容量
    map.shrink_to(50);
    assert!(map.capacity() >= 50);
    
    // 自动调整到合适大小
    map.shrink_to_fit();
    assert!(map.capacity() >= 2);
}

所有权规则

HashMap的所有权规则与Rust的其他部分一致：

对于实现了Copy trait的类型，值会被复制到HashMap中
对于拥有所有权的类型（如String），所有权会被转移到HashMap中

use std::collections::HashMap;

fn main() {
    let v1 = 10; // i32实现了Copy
    let mut m1 = HashMap::new();
    m1.insert(v1, v1); // v1被复制
    println!("v1 is still usable: {}", v1);
    
    let v2 = "hello".to_string(); // String没有实现Copy
    let mut m2 = HashMap::new();
    m2.insert(v2, v1); // v2的所有权被转移
    // 这里不能再使用v2
}

性能优化

如果默认的哈希算法不能满足你的性能需求，可以使用第三方哈希算法：

use std::hash::BuildHasherDefault;
use std::collections::HashMap;
use twox_hash::XxHash64;

fn main() {
    let mut hash: HashMap<_, _, BuildHasherDefault<XxHash64>> = Default::default();
    hash.insert(42, "the answer");
    assert_eq!(hash.get(&42), Some(&"the answer"));
}