使用字符串存储 UTF-8 编码文本

我们在第 4 章中讨论过字符串,但现在我们将更深入地研究它们。新的 Rustaceans 通常会因以下三个原因的组合而陷入字符串的困境:Rust 倾向于暴露可能发生的错误,字符串是一种比许多程序员认为的更复杂的数据结构,以及 UTF-8。当您从其他编程语言转过来时,这些因素的组合可能会让您感到困难。

我们之所以在集合的上下文中讨论字符串,是因为字符串被实现为字节集合,以及一些在这些字节被解释为文本时提供有用功能的方法。在本节中,我们将讨论每个集合类型都具有的 String 操作,例如创建、更新和读取。我们还将讨论 String 与其他集合的不同之处,即人们和计算机如何解释 String 数据之间的差异使得对 String 进行索引变得复杂。

什么是字符串?

我们首先定义术语字符串的含义。Rust 在核心语言中只有一个字符串类型,即字符串切片 str,它通常以借用形式 &str 出现。在第 4 章中,我们讨论了字符串切片,它是对存储在其他地方的一些 UTF-8 编码字符串数据的引用。例如,字符串字面量存储在程序的二进制文件中,因此是字符串切片。

String 类型由 Rust 的标准库提供,而不是编码到核心语言中,它是一种可增长、可变、拥有的 UTF-8 编码字符串类型。当 Rustaceans 在 Rust 中提到“字符串”时,他们可能指的是 String 或字符串切片 &str 类型,而不仅仅是其中一种类型。虽然本节主要介绍 String,但两种类型都在 Rust 的标准库中大量使用,并且 String 和字符串切片都是 UTF-8 编码的。

创建一个新的字符串

许多与 Vec<T> 一起使用的操作也可以与 String 一起使用,因为 String 实际上是作为字节向量的包装器实现的,具有一些额外的保证、限制和功能。Vec<T>String 以相同方式工作的函数的一个示例是 new 函数,用于创建实例,如清单 8-11 所示。

fn main() {
    let mut s = String::new();
}

清单 8-11:创建一个新的空 String

此行创建一个名为 s 的新的空字符串,我们可以将数据加载到其中。通常,我们会有一些想要启动字符串的初始数据。为此,我们使用 to_string 方法,该方法适用于任何实现 Display 特征的类型,如字符串字面量一样。清单 8-12 显示了两个示例。

fn main() {
    let data = "initial contents";

    let s = data.to_string();

    // the method also works on a literal directly:
    let s = "initial contents".to_string();
}

清单 8-12:使用 to_string 方法从字符串字面量创建 String

此代码创建一个包含 initial contents 的字符串。

我们还可以使用函数 String::from 从字符串字面量创建 String。清单 8-13 中的代码等效于清单 8-12 中使用 to_string 的代码。

fn main() {
    let s = String::from("initial contents");
}

清单 8-13:使用 String::from 函数从字符串字面量创建 String

因为字符串用于很多事情,所以我们可以对字符串使用许多不同的通用 API,这为我们提供了很多选择。其中一些可能看起来是多余的,但它们都有其用途!在这种情况下,String::fromto_string 执行相同的操作,因此您选择哪一个取决于风格和可读性。

请记住,字符串是 UTF-8 编码的,因此我们可以在其中包含任何正确编码的数据,如清单 8-14 所示。

fn main() {
    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");
}

清单 8-14:在字符串中存储不同语言的问候语

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

更新字符串

String 的大小可以增长,其内容可以更改,就像 Vec<T> 的内容一样,如果您向其中推送更多数据。此外,您可以方便地使用 + 运算符或 format! 宏来连接 String 值。

使用 push_strpush 追加到字符串

我们可以使用 push_str 方法附加一个字符串切片来增长 String,如清单 8-15 所示。

fn main() {
    let mut s = String::from("foo");
    s.push_str("bar");
}

清单 8-15:使用 push_str 方法将字符串切片追加到 String

在这两行之后,s 将包含 foobarpush_str 方法采用字符串切片,因为我们不一定想要获取参数的所有权。例如,在清单 8-16 的代码中,我们希望在将 s2 的内容附加到 s1 后能够使用 s2

fn main() {
    let mut s1 = String::from("foo");
    let s2 = "bar";
    s1.push_str(s2);
    println!("s2 is {s2}");
}

清单 8-16:在将字符串切片的内容附加到 String 后使用字符串切片

如果 push_str 方法获取了 s2 的所有权,我们将无法在最后一行打印其值。但是,此代码会按预期工作!

push 方法采用单个字符作为参数,并将其添加到 String。清单 8-17 使用 push 方法将字母 l 添加到 String

fn main() {
    let mut s = String::from("lo");
    s.push('l');
}

清单 8-17:使用 push 将一个字符添加到 String

因此,s 将包含 lol

使用 + 运算符或 format! 宏进行连接

通常,您需要组合两个现有的字符串。一种方法是使用 + 运算符,如清单 8-18 所示。

fn main() {
    let s1 = String::from("Hello, ");
    let s2 = String::from("world!");
    let s3 = s1 + &s2; // note s1 has been moved here and can no longer be used
}

清单 8-18:使用 + 运算符将两个 String 值组合成一个新的 String

字符串 s3 将包含 Hello, world!。添加后 s1 不再有效的原因,以及我们使用 s2 的引用的原因,都与我们使用 + 运算符时调用的方法的签名有关。+ 运算符使用 add 方法,其签名如下所示

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

在标准库中,您会看到使用泛型和关联类型定义的 add。在这里,我们替换了具体的类型,这是当我们使用 String 值调用此方法时发生的事情。我们将在第 10 章中讨论泛型。此签名提供了我们需要了解 + 运算符的棘手部分的线索。

首先,s2 有一个 &,这意味着我们将第二个字符串的引用添加到第一个字符串。这是因为 add 函数中的 s 参数:我们只能将 &str 添加到 String;我们不能将两个 String 值加在一起。但是等等 - &s2 的类型是 &String,而不是 add 的第二个参数中指定的 &str。那么为什么清单 8-18 可以编译?

我们之所以能够在对 add 的调用中使用 &s2,是因为编译器可以将 &String 参数强制转换&str。当我们调用 add 方法时,Rust 使用解引用强制转换,在这里将 &s2 转换为 &s2[..]。我们将在第 15 章中更深入地讨论解引用强制转换。因为 add 不获取 s 参数的所有权,所以在此操作之后 s2 仍然是一个有效的 String

其次,我们可以从签名中看到,add 获取了 self 的所有权,因为 self 没有 &。这意味着清单 8-18 中的 s1 将被移动到 add 调用中,并且在那之后将不再有效。因此,尽管 let s3 = s1 + &s2; 看起来会复制两个字符串并创建一个新字符串,但此语句实际上获取了 s1 的所有权,附加了 s2 内容的副本,然后返回结果的所有权。换句话说,它看起来像是进行了很多复制,但实际上并非如此;实现比复制更有效。

如果我们需要连接多个字符串,+ 运算符的行为会变得笨拙

fn main() {
    let s1 = String::from("tic");
    let s2 = String::from("tac");
    let s3 = String::from("toe");

    let s = s1 + "-" + &s2 + "-" + &s3;
}

此时,s 将是 tic-tac-toe。有了所有 +" 字符,很难看出发生了什么。为了以更复杂的方式组合字符串,我们可以改用 format!

fn main() {
    let s1 = String::from("tic");
    let s2 = String::from("tac");
    let s3 = String::from("toe");

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

此代码也将 s 设置为 tic-tac-toeformat! 宏的工作方式类似于 println!,但它不是将输出打印到屏幕上,而是返回一个包含内容的 String。使用 format! 的代码版本更容易阅读,并且 format! 宏生成的代码使用引用,因此此调用不会获取其任何参数的所有权。

对字符串进行索引

在许多其他编程语言中,通过索引引用字符串中的单个字符是一种有效且常见的操作。但是,如果您尝试在 Rust 中使用索引语法访问 String 的部分,则会收到错误。考虑清单 8-19 中的无效代码。

fn main() {
    let s1 = String::from("hello");
    let h = s1[0];
}

清单 8-19:尝试将索引语法与 String 一起使用

此代码将导致以下错误

$ cargo run
   Compiling collections v0.1.0 (file:///projects/collections)
error[E0277]: the type `str` cannot be indexed by `{integer}`
 --> src/main.rs:3:16
  |
3 |     let h = s1[0];
  |                ^ string indices are ranges of `usize`
  |
  = help: the trait `SliceIndex<str>` is not implemented for `{integer}`, which is required by `String: Index<_>`
  = note: you can use `.chars().nth()` or `.bytes().nth()`
          for more information, see chapter 8 in The Book: <https://doc.rust-lang.net.cn/book/ch08-02-strings.html#indexing-into-strings>
  = help: the trait `SliceIndex<[_]>` is implemented for `usize`
  = help: for that trait implementation, expected `[_]`, found `str`
  = note: required for `String` to implement `Index<{integer}>`

For more information about this error, try `rustc --explain E0277`.
error: could not compile `collections` (bin "collections") due to 1 previous error

错误和注释说明了原因:Rust 字符串不支持索引。但是为什么不支持?要回答这个问题,我们需要讨论 Rust 如何在内存中存储字符串。

内部表示

StringVec<u8> 的包装器。让我们看一下清单 8-14 中的一些正确编码的 UTF-8 示例字符串。首先,是这个

fn main() {
    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");
}

在这种情况下,len 将为 4,这意味着存储字符串 "Hola" 的向量的长度为 4 个字节。这些字母中的每一个在 UTF-8 中编码时都占用一个字节。但是,下一行可能会让您感到惊讶(请注意,此字符串以大写西里尔字母 Ze 开头,而不是数字 3)

fn main() {
    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");
}

如果您被问到字符串的长度,您可能会说 12。实际上,Rust 的答案是 24:这是用 UTF-8 编码“Здравствуйте”所需的字节数,因为该字符串中的每个 Unicode 标量值都占用 2 个字节的存储空间。因此,字符串字节的索引并不总是与有效的 Unicode 标量值相关联。为了演示,请考虑以下无效的 Rust 代码

let hello = "Здравствуйте";
let answer = &hello[0];

您已经知道 answer 不会是第一个字母 З。当以 UTF-8 编码时,З 的第一个字节是 208,第二个字节是 151,因此似乎 answer 实际上应该是 208,但是 208 本身不是一个有效的字符。如果用户要求此字符串的第一个字母,则返回 208 可能不是用户想要的;但是,这是 Rust 在字节索引 0 处拥有的唯一数据。用户通常不想要返回字节值,即使字符串仅包含拉丁字母:如果 &"hello"[0] 是返回字节值的有效代码,它将返回 104,而不是 h

因此,答案是,为了避免返回意外值并导致可能不会立即发现的错误,Rust 根本不会编译此代码,并在开发过程的早期防止误解。

字节和标量值和字素簇!我的天啊!

关于 UTF-8 的另一点是,从 Rust 的角度来看,实际上有三种相关的方式来看待字符串:作为字节、标量值和字形簇(最接近我们所说的字母)。

如果我们看一下用天城文书写的印地语单词“नमस्ते”,它存储为 u8 值的向量,看起来像这样

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

这是 18 个字节,也是计算机最终存储此数据的方式。如果我们将其视为 Unicode 标量值(即 Rust 的 char 类型),则这些字节看起来像这样

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

这里有六个 char 值,但第四个和第六个不是字母:它们是单独没有意义的变音符号。最后,如果我们将其视为字形簇,我们就会得到人们所说的构成印地语单词的四个字母

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

Rust 提供了不同的方式来解释计算机存储的原始字符串数据,以便每个程序可以选择它需要的解释,无论数据是什么人类语言。

Rust 不允许我们索引到 String 以获取字符的最后一个原因是,索引操作预计始终采用恒定时间 (O(1))。但是,对于 String 来说,不可能保证这种性能,因为 Rust 必须从头开始遍历内容到索引,以确定有多少个有效字符。

字符串切片

索引到字符串通常是一个坏主意,因为它不清楚字符串索引操作的返回类型应该是什么:字节值、字符、字形簇还是字符串切片。因此,如果你真的需要使用索引来创建字符串切片,Rust 会要求你更具体地说明。

你可以使用带有范围的 [] 而不是使用带有单个数字的 [] 进行索引,以创建包含特定字节的字符串切片

#![allow(unused)]
fn main() {
let hello = "Здравствуйте";

let s = &hello[0..4];
}

这里,s 将是一个 &str,它包含字符串的前四个字节。早些时候,我们提到这些字符中的每一个都是两个字节,这意味着 s 将是 Зд

如果我们尝试仅用类似 &hello[0..1] 的方式对字符的一部分字节进行切片,Rust 会在运行时出现 panic,就像访问向量中的无效索引一样

$ cargo run
   Compiling collections v0.1.0 (file:///projects/collections)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.43s
     Running `target/debug/collections`
thread 'main' panicked at src/main.rs:4:19:
byte index 1 is not a char boundary; it is inside 'З' (bytes 0..2) of `Здравствуйте`
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

使用范围创建字符串切片时应谨慎,因为这样做可能会使你的程序崩溃。

用于迭代字符串的方法

处理字符串片段的最佳方法是明确说明你想要的是字符还是字节。对于单个 Unicode 标量值,请使用 chars 方法。在“Зд”上调用 chars 会分离并返回两个 char 类型的值,你可以迭代结果以访问每个元素

#![allow(unused)]
fn main() {
for c in "Зд".chars() {
    println!("{c}");
}
}

此代码将打印以下内容

З
д

或者,bytes 方法会返回每个原始字节,这可能适用于你的领域

#![allow(unused)]
fn main() {
for b in "Зд".bytes() {
    println!("{b}");
}
}

此代码将打印构成此字符串的四个字节

208
151
208
180

但请务必记住,有效的 Unicode 标量值可能由多个字节组成。

从字符串中获取字形簇(如天城文)很复杂,因此标准库不提供此功能。 crates.io 上提供了 Crate如果你需要此功能。

字符串并非如此简单

总而言之,字符串很复杂。不同的编程语言对如何向程序员展示这种复杂性做出了不同的选择。Rust 选择使所有 Rust 程序都默认正确处理 String 数据,这意味着程序员必须预先花更多心思来处理 UTF-8 数据。这种权衡暴露了字符串的更多复杂性,而不是其他编程语言中显而易见的复杂性,但这可以防止你在开发生命周期的后期处理涉及非 ASCII 字符的错误。

好消息是,标准库提供了许多基于 String&str 类型构建的功能,以帮助正确处理这些复杂情况。请务必查看文档,了解有用的方法,如用于在字符串中搜索的 contains 和用于将字符串的一部分替换为另一个字符串的 replace

让我们转到一些不太复杂的内容:哈希映射!