arcstr: 更好的引用计数字符串。

此 crate 定义了 ArcStr，一个引用计数字符串类型。它本质上试图成为一个更好的 Arc<str> 或 Arc<String>，至少对于大多数用例。

ArcStr 故意放弃了 Arc 中一些很少使用的功能，例如 Weak、Arc::make_mut 等。作为交换，它获得了许多非常有用的功能，特别是对字符串。特别是对便宜/无成本的 ArcStr 持有静态数据（例如，字符串字面量）的强大支持。

（除此之外，它还是单指针，这可以提高性能和 FFI）

此外，如果启用了 substr 功能（默认情况下是启用的），我们提供了一个 Substr 类型，它本质上是一个 (ArcStr, Range<usize>)，具有更好的易用性和更多功能，它表示一个“父” ArcStr 的共享切片（请注意，实际上使用 u32 作为索引类型，但此 API 中未暴露，可以通过 cargo 功能透明地更改）。

功能概述

快速浏览ArcStr的独特特性（注意，在ArcStr的[文档](https://docs.rs/arcstr/%2a/arcstr/struct.ArcStr.html#benefits-of-arcstr-over-arcstr)中有一个关于ArcStr相对于其他替代方案的[优势列表](https://docs.rs/arcstr/%2a/arcstr/struct.ArcStr.html#benefits-of-arcstr-over-arcstr)，其中涵盖了一些你可能希望使用它的原因）。注意，它提供了您可能从不可变字符串类型期望的几乎所有字符串-like功能——这些只是独特的卖点。

use arcstr::ArcStr;
// Works in const:
const AMAZING: ArcStr = arcstr::literal!("amazing constant");
assert_eq!(AMAZING, "amazing constant");

// `arcstr::literal!` input can come from `include_str!` too:
const MY_BEST_FILES: ArcStr = arcstr::literal!(include_str!("my-best-files.txt"));

或者，您可以在普通表达式中定义字面量。注意，这些字面量本质上属于"零成本"。具体来说，以下我们不仅没有为实例化wow或任何克隆分配堆内存，而且在克隆、丢弃（或在任何其他操作它们的过程中）时也不需要进行任何原子读取或写入。

let wow: ArcStr = arcstr::literal!("Wow!");
assert_eq!("Wow!", wow);
// This line is probably not something you want to do regularly,
// but as mentioned, causes no extra allocations, nor performs any
// atomic loads, stores, rmws, etc.
let wowzers = wow.clone().clone().clone().clone();

// At some point in the future, we can get a `&'static str` out of one
// of the literal `ArcStr`s too.
let static_str: Option<&'static str> = ArcStr::as_static(&wowzers);
assert_eq!(static_str, Some("Wow!"));

// Note that this returns `None` for dynamically allocated `ArcStr`:
let dynamic_arc = ArcStr::from(format!("cool {}", 123));
assert_eq!(ArcStr::as_static(&dynamic_arc), None);

待办事项：在此处包含Substr的使用，因为它也有一些令人信服的应用场景！

用法

它是一个普通的Rust包，将其添加到您的Cargo.toml的依赖项部分。在您不太可能在这里的情况下，不知道如何操作

[dependencies]
# ...
arcstr = { version = "...", features = ["..."] }

以下是一些可用的Cargo功能。目前默认启用的是substr。

• std（默认关闭）：启用后，将使用std::process的终止，而不是使用“双重panic技巧”触发终止。

  基本上，我们需要终止的一种情况是在发生灾难性错误时，您泄露了相同的（动态）ArcStr（在32位系统上为2^31，在64位系统上为2^63）。如果发生这种情况，我们将遵循libstd的先例并直接终止，因为我们已经陷入困境。如果启用了std，我们将使用真实的std::process::abort。如果未启用std，我们将通过在另一个panic正在展开时触发panic来触发abort，这要么被定义为导致终止，要么在实践中导致终止。

  实际上，您永远也不会遇到这种边缘情况，而且它仍在no_std中正常工作，因此no_std是默认设置。如果您必须将其启用，因为您遇到了这种情况并且发现我们的处理不好，请让我知道。

  具体来说，这里的区别是，如果没有这个，这个情况将变成对core::intrinsics::abort的调用，而不是对std::process::abort的调用。这是一个极不可能遇到的边缘情况，但如果您遇到了，使用std::process::abort将导致SIGABRT，而使用core::intrinsics::abort将导致SIGILL，前者具有明显更好的用户体验。话虽如此，您成功泄露2^31或2^63个相同的ArcStr副本的可能性极低，因此我们认为默认情况下依赖std并不是很有必要。

• serde（默认关闭）：启用ArcStr的serde序列化。请注意，这不会执行任何复杂的去重或其他操作。

• substr （默认开启）：实现 Substr 类型和相关函数。

• substr-usize-indices（默认关闭，隐含 substr）：底层使用 usize 作为边界，而不是 u32。

  如果没有这个，如果你使用 Substr 并且索引会溢出 u32，我们会毫不犹豫地 panic。