10 集合

集合(collections)是rust中非常有用的数据结构,下面会逐个介绍三种集合。

10.1 String

字符串切片

切片在前面介绍数组时有简单提到,它是一类引用,没有所有权。

1
2
3
4
let s = String::from("hello world");

let hello = &s[0..5];
let world = &s[6..11];

sString类型,hello 没有引用整个 String s,而是引用了 s 的一部分内容,通过 [0..5] 的方式来指定。这就是创建切片的语法,使用方括号包括的一个序列:[开始索引..终止索引],其中开始索引是切片中第一个元素的索引位置,而终止索引是最后一个元素后面的索引位置,这是一个[)右半开区间。在切片数据结构内部会保存开始的位置和切片的长度,其中长度是通过 终止索引 - 开始索引 的方式计算得来的。

..除了用于解构,在这里是生成连续序列的意思,如果你想从索引 0 开始,可以使用如下的方式,这两个是等效的:

1
2
let slice = &s[0..2];
let slice = &s[..2];

同样的,如果你的切片想要包含 String 的最后一个字节,则可以这样使用:

1
2
3
4
5
6
let s = String::from("hello");

let len = s.len();

let slice = &s[4..len];
let slice = &s[4..];

你也可以截取完整的 String 切片:

1
2
3
4
5
6
let s = String::from("hello");

let len = s.len();

let slice = &s[0..len];
let slice = &s[..];

但通常,字符串切片是非常危险的操作,具体原因请继续往下看。

字符串的字面值是切片

对于:

1
let s = "Hello, world!";

s 的类型是 &str,因此你也可以这样声明:

1
let s: &str = "Hello, world!";

这也是为什么字符串字面量是不可变的,因为 &str 是一个不可变引用。

字符串

字符串是由字符组成的连续集合。rust中的字符是Unicode类型,因此每个字符占据4个字节内存空间,但是在字符串中不一样,字符串是UTF-8编码,也就是字符串中的字符所占的字节数是变化的(1 - 4),这样有助于大幅降低字符串所占用的内存空间

String是常用的数据类型,它是在标准库中定义的。rust在语言级别只有一种数据类型str,它通常以引用的形式&str出现,也就是字符串切片,也叫做字符串的字面值。

str 类型硬编码进可执行文件,也无法被修改,但是String则是一个可增长、可改变且具有所有权的UTF-8编码字符串。当用户提到字符串时,往往指的就是String类型和&str字符串切片类型,这两个类型都是UTF-8编码。

创建字符串与转换类型

1
let mut s = String::new();

通过new可以新建一个空字符串。但更多时候,我们需要&strString相互转换。

首先是从 &str 类型生成 String 类型:

1
2
let s = String::from("initial contents");
let t = "hello,world".to_string();

这两种生成方式得到的效果是一样的,String::from.to_string 最终做了完全相同的工作,所以如何选择就是代码风格与可读性的问题了。

String 类型转为 &str 类型也非常简单,取引用即可:

1
2
3
4
5
6
7
8
9
10
fn main() {
let s = String::from("hello,world!");
say_hello(&s);
say_hello(&s[..]);
say_hello(s.as_str());
}

fn say_hello(s: &str) {
println!("{}",s);
}

字符串的编码

字符串是UTF-8编码,所以可以包含任何可以正确编码的数据:

1
2
3
4
5
6
7
8
9
10
11
let hello = String::from("السلام عليكم");
let hello = String::from("Dobrý den");
let hello = String::from("Hello");
let hello = String::from("שָׁלוֹם");
let hello = String::from("नमस्ते");
let hello = String::from("こんにちは");
let hello = String::from("안녕하세요");
let hello = String::from("你好");
let hello = String::from("Olá");
let hello = String::from("Здравствуйте");
let hello = String::from("Hola");

所有这些都是有效的 String 值。

字符串索引

在很多语言中,通过索引来引用字符串中的单独字符是有效且常见的操作。然而在 Rust 中,如果你尝试使用索引语法访问 String 的一部分,会出现错误:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
fn main() {
let s1 = String::from("hello");
let h = s1[0];
}
/* 你将得到如下错误:
|
13 | let h = s1[0];
| ^^^^^ `String` cannot be indexed by `{integer}`
|
= help: the trait `Index<{integer}>` is not implemented for `String`
= help: the following other types implement trait `Index<Idx>`:
<String as Index<RangeFrom<usize>>>
<String as Index<RangeFull>>
<String as Index<RangeInclusive<usize>>>
<String as Index<RangeTo<usize>>>
<String as Index<RangeToInclusive<usize>>>
<String as Index<std::ops::Range<usize>>>
*/

错误提示告诉我们,rust的字符串不支持索引。这是因为字符串在内存中的存储决定的。

内部表现

字符串的底层的数据存储格式实际上是一个u8类型的字节数组。前面举了一些UTF-8的字符串例子,比如:

1
2
3
4
5
fn main() {
let s1 = String::from("hola");
let len = s1.len(); // .len 方法用于获取数组的长度,在这里就是字节数
println!("{}", len);
}

在这里,len的值是4,因为Hola中的每个字母在UTF-8编码中仅占用1个字节,但是对于:

1
2
3
4
5
fn main() {
let s1 = String::from("你好世界");
let len = s1.len();
println!("{}", len);
}

len 的值是12,因为一个中文字符需要3个字节存储。在这种情况下,假如对s1取索引&s1[0],并不会返回,而是这3个字节中的第1个字节,这显然不是用户想要的结果。为了避免返回意外的值并造成不能立刻发现的bug,rust根本不会编译这些代码,并在开发过程中及早杜绝了误会的发生。

这引起了关于UTF-8的另外一个问题:从rust的角度来讲,事实上有三种相关方式可以理解字符串:字节、标量值和字母。

比如这个用梵文书写的印度语单词 “नमस्ते”,它底层的字节数组是如下形式:

1
2
[224, 164, 168, 224, 164, 174, 224, 164, 184, 224, 165, 141, 224, 164, 164,
224, 165, 135]

这里有 18 个字节,也就是计算机最终会储存的数据。

如果从Unicode标量值的角度理解它们,也就像rust的char类型那样,这些字节看起来像这样:

1
['न', 'म', 'स', '्', 'त', 'े']

这里有六个 char,不过第四个和第六个都不是字母,它们是发音符号本身并没有任何意义。最后,如果以字母的角度理解:

1
["न", "म", "स्", "ते"]

rust提供了多种不同的方式来解释计算机储存的原始字符串数据,这样程序就可以选择它需要的表现方式,而无所谓是何种人类语言。

最后一个rust不允许使用索引获取 String 字符的原因是,索引操作预期总是需要常数时间O(1)。但是对于String不可能保证这样的性能,因为rust必须从开头到索引位置遍历来确定有多少有效的字符。

字符串切片可能造成的问题

前面提到,字符串切片是非常危险的操作,这正是由于字符串索引返回的东西不明确。因此,如果你真的希望使用索引创建字符串切片时,需要你更明确一些。为了更明确索引并表明你需要一个字符串 slice,相比使用 [] 和单个值的索引,可以使用 [] 和一个range来创建含特定字节的字符串切片:

1
2
let hello = "中国人";
let s = &hello[0..3];

这里,s 会是一个 &str,它包含字符串的前3个字节,也就是。但是,如果你取错了索引:

1
let s = &hello[0..2];

那么就会在运行时painc。你应该小心谨慎地使用这个操作,因为这么做可能会使你的程序崩溃。

字符串操作

String是动态可增加的,其内容也可以改变,下面介绍字符串的修改,添加,删除等常用方法。

追加

可以通过 push_str 方法来附加字符串切片,从而使 String 变长:

1
2
3
4
5
6
7
fn main() {
let mut s1 = String::from("foo");
let s2 = "bar";
s1.push_str(s2);
println!("s1 is {s1}");
println!("s2 is {s2}");
}

s2并没有在push_str后失效,这是因为我们使用的是字符串字面值,并不需要获取参数的所有权。

还可以使用pushpush 方法被定义为获取一个单独的字符作为参数,并附加到 String 中:

1
2
3
4
5
fn main() {
let mut s = String::from("lo");
s.push('l');
println!("{}",s)
}

这两个方法都是在原有的字符串上追加,并不会返回新的字符串。由于字符串追加操作要修改原来的字符串,则被添加的字符串必须是可变的,需要用mut

拼接字符串

通常你会希望将两个已知的字符串合并在一起。一种办法是使用 + 运算符。

1
2
3
4
5
6
fn main() {
let s1 = String::from("hello");
let s2 = String::from("world");
let s3 = s1 + &s2;
println!("{}",s3);
}

这里有一些细节需要注意,首先,我们将两个字符串拼接的时候,需要使用+,左边是s1,而右边则获取了引用&s2。并且,如果你在最后打印s1,会发现它不再有效,这是由于+运算背后调用了标准库的add方法,函数签名看起来像这样:

1
fn add(self, s: &str) -> String {}

根据前几章的内容可以得知,我们使用第二个字符串的引用与第一个字符串相加。这是因为 add 函数的 s 参数:只能将 &strString 相加,不能将两个 String 值相加。不过正如 add 的第二个参数所指定的,&s2 的类型是 &String 而不是 &str。那么为什么还能通过编译呢?之所以能够在 add 调用中使用 &s2 是因为 &String 可以被强转(coerced)成 &str。当add函数被调用时,rust使用了一个被称为Deref 强制转换(deref coercion)的技术,你可以将其理解为它把 &s2 变成了 &s2[..]

其次,可以发现签名中 add 获取了 self 的所有权,因为self没有使用 &。这意味着s1 的所有权将被移动到 add 调用中,之后就不再有效。所以虽然 let s3 = s1 + &s2; 看起来就像它会复制两个字符串并创建一个新的字符串,而实际上这个语句会获取 s1 的所有权,附加上从 s2 中拷贝的内容,并返回结果的所有权。换句话说,它看起来好像生成了很多拷贝,不过实际上并没有:这个实现比拷贝要更高效。

另外也可以使用+=

1
2
3
4
5
6
fn main() {
let mut s1 = String::from("hello");
let s2 = String::from("world");
s1 += &s2;
println!("{}",s1);
}

如果需要多个字符串拼接,+就不太方便了,此时可以使用format!宏:

1
2
3
4
5
6
7
8
fn main() {
let s1 = String::from("tic");
let s2 = String::from("tac");
let s3 = String::from("toe");

let s = format!("{s1}-{s2}-{s3}");
println!("{}",s);
}

format!println! 的工作原理相同,不过不同于将输出打印到屏幕上,它返回一个带有结果内容的 String。这个版本就好理解的多,宏 format! 生成的代码使用引用所以不会获取任何参数的所有权。

插入

使用 insert() 方法插入单个字符 char,也可以使用 insert_str() 方法插入字符串字面值。这两个方法需要传入两个参数,一个是待插入的值,另一个是插入的位置索引,索引从 0 开始计数,如果越界则会发生错误。由于字符串插入操作要修改原来的字符串,则该字符串必须是可变的,即字符串变量必须由mut关键字修饰。

1
2
3
4
5
6
7
8
fn main() {
let mut s = String::from("Hello world!");
println!("{}",s);
s.insert_str(0,"hello");
println!("{}",s);
s.insert(0,'a');
println!("{}",s);
}
替换

如果想要把字符串中的某个字符串替换成其它的字符串,那可以使用 replace() 方法。与替换有关的方法有三个。

  1. replace

    用于String&str 类型。replace() 方法接收两个参数,第一个参数是要被替换的字符串,第二个参数是新的字符串。该方法会替换所有匹配到的字符串。该方法是返回一个新的字符串,而不是操作原来的字符串。

    1
    2
    3
    4
    5
    fn main() {
    let string_replace = String::from("I like rust. Learning rust is my favorite!");
    let new_string_replace = string_replace.replace("rust", "RUST");
    println!("{}",new_string_replace);
    }
  2. replacen

    该方法可适用于 String&str 类型。replacen() 方法接收三个参数,前两个参数与 replace() 方法一样,第三个参数则表示替换的个数。同样返回一个新的字符串,而不是操作原来的字符串。

    1
    2
    3
    4
    5
    fn main() {
    let string_replace = String::from("I like rust. Learning rust is my favorite!");
    let new_string_replace = string_replace.replacen("rust", "RUST",1);
    println!("{}",new_string_replace);
    }
  3. replace_range

    该方法仅适用于 String 类型。replace_range 接收两个参数,第一个参数是要替换字符串的范围(Range),第二个参数是新的字符串。该方法是直接操作原来的字符串,不会返回新的字符串。因此被操作字符串需要使用 mut 关键字修饰。

    1
    2
    3
    4
    5
    fn main() {
    let mut string_replace_range = String::from("I like rust!");
    string_replace_range.replace_range(7..8, "R");
    println!("{}",string_replace_range);
    }

    将索引范围是[7,8)区间内的字符替换为字符串R

删除

与字符串删除相关的方法有 4 个,他们分别是 pop()remove()truncate()clear()。这四个方法仅适用于 String 类型,并且直接在原地操作,需要使用mut修饰。

  1. pop

    该方法删除并返回字符串的最后一个字符,返回值是一个 Option ,如果字符串为空,则返回 None

    1
    2
    3
    4
    5
    6
    7
    8
    fn main() {
    let mut s = String::from("I like rust!");
    let t = s.pop();
    if let Some(x) = t {
    println!("{}", x);
    }
    println!("{}", s);
    }
  2. remove

    该方法删除并返回字符串中指定位置的字符。接收一个参数即要删除的索引位置,如果索引越界则会panic

    1
    2
    3
    4
    5
    6
    fn main() {
    let mut s = String::from("I like rust!");
    let t = s.remove(3);
    println!("{}", t);
    println!("{}", s);
    }
  3. truncate

    该方法删除字符串中从指定位置开始到结尾的全部字符,无返回值,索引越界则会panic

    1
    2
    3
    4
    5
    6
    fn main() {
    let mut s = String::from("I like rust!");
    s.truncate(5);

    println!("{}", s);
    }
  4. clear

    该方法清空字符串,相当于truncate(0)

    1
    2
    3
    4
    5
    6
    fn main() {
    let mut s = String::from("I like rust!");
    s.clear();

    println!("{}", s);
    }

更多方法,请参阅官方文档

转义字符串

我们可以通过转义的方式\输出ASCIIUnicode字符。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
fn main() {
// 通过 \ + 字符的十六进制表示,转义输出一个字符
let byte_escape = "I'm writing \x52\x75\x73\x74!";
println!("What are you doing\x3F (\\x3F means ?) {}", byte_escape);

// \u 可以输出一个 unicode 字符
let unicode_codepoint = "\u{211D}";
let character_name = "\"DOUBLE-STRUCK CAPITAL R\"";

println!(
"Unicode character {} (U+211D) is called {}",
unicode_codepoint, character_name
);

// 换行了也会保持之前的字符串格式
let long_string = "String literals
can span multiple lines.
The linebreak and indentation here ->\
<- can be escaped too!";
println!("{}", long_string);
}

当然,在某些情况下,可能你会希望保持字符串的原样,不要转义:

1
2
3
4
5
6
7
8
9
10
11
12
13
fn main() {
println!("{}", "hello \\x52\\x75\\x73\\x74");
let raw_str = r"Escapes don't work here: \x3F \u{211D}";
println!("{}", raw_str);

// 如果字符串包含双引号,可以在开头和结尾加 #
let quotes = r#"And then I said: "There is no escape!""#;
println!("{}", quotes);

// 如果还是有歧义,可以继续增加,没有限制
let longer_delimiter = r###"A string with "# in it. And even "##!"###;
println!("{}", longer_delimiter);
}

操作UTF-8字符串

如果你想要以Unicode字符的方式遍历字符串,最好的办法是使用 chars 方法,例如:

1
2
3
for c in "中国人".chars() {
println!("{}", c);
}

以字节形式遍历,使用bytes

1
2
3
for b in "中国人".bytes() {
println!("{}", b);
}

想要准确的从 UTF-8 字符串中获取子串是较为复杂的事情,例如想要从 holla中国人नमस्ते 这种变长的字符串中取出某一个子串,使用标准库是做不到的。 需要在 crates.io 上搜索 utf8 来寻找想要的功能:考虑使用utf8_slice

总而言之,字符串还是很复杂的。不同的语言选择了不同的向程序员展示其复杂性的方式。rust选择了较为复杂、更加准确的方式。这种权衡取舍相比其他语言更多的暴露出了字符串的复杂性,不过也使你在开发周期后期免于处理涉及非 ASCII字符的错误。

10.2 动态数组 Vector

动态数组Vec<T>也被称为vector,是长度可增长的数组,下面介绍它的基本使用。

创建动态数组

创建新的空vector,可以调用 Vec::new 函数:

1
let v: Vec<i32> = Vec::new();

这里显式增加了一个类型标注Vec<i32>,编译器可以得知v中的元素是i32类型。如果去掉标注,由于动态数组是通过泛型实现的,rust并不知道我们想要储存什么类型的元素。

当然,rust可以通过类型推断来确定动态数组的类型:

1
2
let mut v = Vec::new();
v.push(1);

首先需要使用mutv变成可变的,然后使用push方法添加一个元素,此时通过类型推断,编译器可以得知v 中的元素类型是 i32,因此推导出 v 的类型是 Vec<i32>

通常,我们会用初始值来创建一个 Vec<T> ,rust会推断出储存值的类型,使用宏 vec! 来创建数组,这个宏会根据我们提供的值来创建一个新的 vector:

1
let v = vec![1, 2, 3];

我们提供了 i32 类型的初始值,rust可以推断出 v 的类型是 Vec<i32>,因此类型注解就不是必须的。

修改动态数组

向数组尾部添加元素,可以使用 push 方法:

1
2
let mut v = Vec::new();
v.push(1);

插入元素insert

1
2
3
4
5
6
7
fn main() {
let mut vec = vec![1, 2, 3];
vec.insert(1, 4);
assert_eq!(vec, [1, 4, 2, 3]);
vec.insert(4, 5);
assert_eq!(vec, [1, 4, 2, 3, 5]);
}

删除并返回数组中最后一个元素:

1
2
3
4
5
fn main() {
let mut vec = vec![1, 2, 3];
assert_eq!(vec.pop(), Some(3));
assert_eq!(vec, [1, 2]);
}

更多方法,可以参阅官方文档

读取数组的元素

有两种方法引用 vector 中储存的值:通过索引或使用 get 方法:

1
2
3
4
5
6
7
8
9
10
11
fn main() {
let v = vec![1, 2, 3, 4, 5];
let third: &i32 = &v[2];
println!("The third element is {third}");

let third: Option<&i32> = v.get(2);
match third {
Some(third) => println!("The third element is {third}"),
None => println!("There is no third element."),
}
}

使用 &[] 会得到一个索引位置元素的引用。当使用索引作为参数调用 get 方法时,会得到一个可以用于 matchOption<&T>枚举类型。

之所以提供两种读取方法,是因为如果索引越界,程序的效果不同,如果是直接取索引:

1
2
3
4
fn main() {
let v = vec![1, 2, 3, 4, 5];
let t: &i32 = &v[100];
}

rust直接会panic,而使用get

1
2
3
4
5
6
7
fn main() {
let v = vec![1, 2, 3, 4, 5];
let t = v.get(100);
if let None = t {
println!("t is None");
}
}

它不会panic而是返回 None,当偶尔出现超过范围的访问属于正常情况的时候可以考虑使用它。接着你的代码可以有处理 Some(&element)None 的逻辑,就像模式匹配里讲的那样。

一旦程序获取了一个有效的引用,借用检查器将会执行所有权和借用规则来确保vector内容的这个引用和任何其他引用保持有效。回忆一下不能在相同作用域中同时存在可变和不可变引用的规则:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
fn main() {
let mut v = vec![1, 2, 3, 4, 5];
let first = &v[0];
v.push(6);
println!("The first element is: {first}");
}
/*
|
13 | let first = &v[0];
| - immutable borrow occurs here
14 | v.push(6);
| ^^^^^^^^^ mutable borrow occurs here
15 | println!("The first element is: {first}");
| ----- immutable borrow later used here
*/

当我们获取了数组的第一个元素的不可变引用并尝试在末尾增加一个元素的时候,如果尝试在函数的后面引用这个元素是行不通的。为什么第一个元素的引用会关心数组结尾的变化?不能这么做的原因是由于动态数组的工作方式:在动态数组的结尾增加新元素时,在没有足够空间将所有元素依次相邻存放的情况下,可能会要求分配新内存并将老的元素拷贝到新的空间中。这时,第一个元素的引用就指向了被释放的内存。借用规则阻止程序陷入这种状况。

遍历数组元素

如果想要依次访问数组中的每一个元素,我们可以遍历其所有的元素而无需通过索引一次一个的访问。

1
2
3
4
5
6
fn main() {
let v = vec![100, 32, 57];
for i in &v {
println!("{i}");
}
}

当然,也可以遍历可变引用,以在循环中改变原始值:

1
2
3
4
5
6
fn main() {
let mut v = vec![100, 32, 57];
for i in &mut v {
*i += 50;
}
}

在其他语言中,有一种不安全的行为,比如,在python的for循环中,不断地向被迭代的对象添加元素:

1
2
3
4
5
arr = [1, 2, 3, 4, 5]

for i in arr:
print(i)
arr.append(0)

就会导致无限循环下去的bug。所以,在这些语言中,应当避免在循环体中对被循环的数组进行插入、删除等操作,在C/C++这样的编译型语言中,编译器也不会给出提醒报错,使得这样的错误有时难以被发现。

而rust则根本解决了这个问题。根据借用检查器的规则,无论可变还是不可变地遍历一个动态数组都是安全的。如果尝试在 for 循环体内插入或删除项,都会得到编译错误。这是因为在for 循环中已经获取了动态数组引用,阻止了同时对动态数组整体的修改,比如

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
fn main() {
let mut v = vec![100, 32, 57];
for i in &v {
println!("{i}");
v.push(3);
}
}
/* 得到如下错误
|
13 | for i in &mut v {
| ------
| |
| first mutable borrow occurs here
| first borrow later used here
14 | println!("{i}");
15 | v.push(3);
| ^^^^^^^^^ second mutable borrow occurs here
*/

即使改成可变引用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
fn main() {
let mut v = vec![100, 32, 57];
for i in &mut v {
println!("{i}");
v.push(3);
}
}
/*
|
13 | for i in &mut v {
| ------
| |
| first mutable borrow occurs here
| first borrow later used here
14 | println!("{i}");
15 | v.push(3);
| ^^^^^^^^^ second mutable borrow occurs here
*/

也会由于“同一个变量的可变引用在同一作用域内最多只能有一个”这样的规则而报错。

动态数组的drop

类似于结构体,动态数组在其离开作用域时会被释放:

1
2
3
{
let v = vec![1, 2, 3, 4];
} // <- v 离开作用域时被drop释放

当动态数组被丢弃时,所有其内容也会被丢弃,这意味着这里它包含的元素将被清理。借用检查器确保了任何数组中内容的引用仅在数组本身有效时才可用。比如:

1
2
3
4
5
6
7
fn main() {
{
let mut v = vec![100, 32, 57];
println!("{}",&v[0]); // 有效
}
println!("{}",&v[0]); // v离开作用域被drop
}

使用动态数组和枚举来存储不同类型的数据

有时候,我们需要在数组中存放不同类型的数据,就像弱类型(js)或动态类型(python)的语言一样。rust中,需要麻烦一些,通过枚举来实现这种需求。

1
2
3
4
5
6
7
8
9
enum Number {
integer(i32),
big_integer(i64),
float(f32),
double(f64),
}
fn main() {
let arr = vec![Number::big_integer(24),Number::float(3.14),Number::double(3.14)];
}

这里的arr中存储的都是枚举类型Number,在枚举成员中会存放这些不同类型的值。rust在编译时就必须准确的知道数组中类型的原因在于,它需要知道储存每个元素到底需要多少内存。但如果在编译时不能确定有多少类型的数据,则无法使用枚举,可以通过特征对象来实现这个需求。留到后面进行讨论,详见特征对象

10.3 哈希表 hashmap

最后介绍的常用集合类型是哈希(hashmap),HashMap<K, V> 类型储存了一个键类型 K 对应一个值类型 V 的映射。很多编程语言支持这种数据结构,不过通常有不同的名字:哈希、map、对象、哈希表、dict或者关联数组等。例如,在一个游戏中,你可以将每个团队的分数记录到hashmap中,其中键是队伍的名字而值是每个队伍的分数。给出一个队名,就能得到他们的得分。

创建hashmap

通过new方法创建:

1
2
3
4
5
6
7
8
use std::collections::HashMap;

fn main() {
let mut scores = HashMap::new();

scores.insert(String::from("Blue"), 10);
scores.insert(String::from("Yellow"), 50);
}

在这三个常用集合中,HashMap 是最不常用的,所以并没有被prelude自动引用,需要通过use引入HashMap,然后创建一个空的scores,并插入两个键值对。和String一样,哈希表将它们的数据储存在堆上,这个 HashMap 的键类型是 String 而值类型是 i32。类似于动态数组,哈希表是同质的:所有的键必须是相同类型,值也必须都是相同类型。

访问hashmap

可以通过 get 方法并提供对应的键来从hashmap中获取值:

1
2
3
4
5
6
7
8
9
10
11
12
use std::collections::HashMap;

fn main() {
let mut scores = HashMap::new();

scores.insert(String::from("Blue"), 10);
scores.insert(String::from("Yellow"), 50);

let team_name = String::from("Blue");
let score = scores.get(&team_name).copied().unwrap_or(0);
println!("{score}");
}

这里,score 是与蓝队分数相关的值,应为 10get 方法返回 Option<&V>,如果某个键在哈希 map 中没有对应的值,get 会返回 None。程序中通过调用 copied 方法来获取一个 Option<i32> 而不是 Option<&i32>,接着调用 unwrap_orscore 中没有该键所对应的项时将其设置为零。

遍历hashmap

可以使用for循环遍历hashmap的所有值:

1
2
3
4
5
6
7
8
9
10
11
12
use std::collections::HashMap;

fn main() {
let mut scores = HashMap::new();

scores.insert(String::from("Blue"), 10);
scores.insert(String::from("Yellow"), 50);

for (key, value) in &scores {
println!("{key}: {value}");
}
}

所有权转移

hashmap的所有权规则与其它类型没有区别,对于实现了Copy特征的类型,该类型会被复制进hashmap;对于没实现 Copy 特征的类型,其值将被移动而hashmap会成为这些值的所有者。

1
2
3
4
5
6
7
8
9
fn main() {
let field_name = String::from("Favorite color");
let field_value = String::from("Blue");

let mut map = HashMap::new();
map.insert(field_name, field_value);
// 这里 field_name 和 field_value 不再有效,
println!("{field_name}"); // 错误,所有权已经被转移进hashmap
}

如果将值的引用插入hashmap,这些值的所有权不会被转移。但是这些引用指向的值必须至少在hashmap有效时也是有效的,看下面的例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
fn main() {
let mut map = HashMap::new();
{
let field_name = String::from("Favorite color");
let field_value = String::from("Blue");
map.insert(&field_name, field_value);
} // 离开这个作用域后,field_name和field_value失效

println!("{:?}", map); // 引用在这里使用
}
/* 收到如下报错
|
18 | map.insert(&field_name, field_value);
| ^^^^^^^^^^^ borrowed value does not live long enough
19 | }
| - `field_name` dropped here while still borrowed
20 |
21 | println!("{:?}", map);
| --- borrow later used here
*/

{}作用域内向hashmap中插入了一对元素,其中,key传入了引用&field_namefield_name的所有权没有被移动,但是在{}作用域结束后,field_name被自动drop后失效,hashmap的仍然保留着的这个引用所指向的值是未知的,无法通过编译。这里涉及到生命周期的概念,后面会进行介绍(见生命周期)。

更新hashmap

当我们想要改变hashmap中的数据时,必须决定如何处理一个键已经有值了的情况。有以下几种处理方法:

  1. 直接覆盖原先的。

    如果我们插入了一个键值对,接着用相同的键插入一个不同的值,与这个键相关联的旧值将被替换。

    1
    2
    3
    4
    5
    6
    fn main() {
    let mut map = HashMap::new();
    map.insert(String::from("aaa"), 3);
    map.insert(String::from("aaa"), 4);
    println!("{:?}", map);
    }

    最终hashmap的值为:{"aaa": 4},最开始的3被覆盖了。

  2. 只在键没有对应值时插入键值对。

    有时可能会需要这样的操作:当插入时,hashmap中不存在这个key,则插入;hashmap存在这个key则不作任何操作。

    为此hashmap提供了一个entry方法,它获取我们想要检查的键作为参数,它的返回值是一个枚举Entry。这个枚举代表了可能存在也可能不存在的值。Entryor_insert 方法在键对应的值存在时就返回这个值的可变引用,如果不存在则将参数作为新值插入并返回新值的可变引用。

    1
    2
    3
    4
    5
    6
    fn main() {
    let mut map = HashMap::new();
    map.insert(String::from("aaa"), 3);
    map.entry(String::from("aaa")).or_insert(5);
    println!("{:?}", map);
    }

    使用or_insert比编写自己的逻辑要简明,另外也与借用检查器结合得更好。

  3. 根据旧值更新一个值。

    另一个常见的应用场景是找到一个键对应的值并根据旧的值更新它。

    1
    2
    3
    4
    5
    6
    7
    8
    fn main() {
    let mut map = HashMap::new();
    map.insert(String::from("aaa"), 3);
    let value = map.entry(String::from("aaa")).or_insert(8);
    *value += 1;

    println!("{:?}", map);
    }

    or_insert 返回了 &mut value 引用,因此可以通过该可变引用直接修改 map 中对应的值,使用引用时,需要解引用*