Lib.rs

这个仅限安全的crate引入了两种新的泛型类型，OurString 和 OurBytes，它们是可定制的共享字符串/字节类型，对小型数据具有自动内联功能。作为共享类型，这些值是不可变的，克隆是 O(1)。

第一个泛型参数是共享的“同志”类型，可以是 Rc<T> 或 Arc<T>，其中 T 可以转换为/从 str 和 [u8] 转换。值得注意的是，这包括 String 和 str 对于 OurString，以及 Vec<u8> 和 [u8] 对于 OurBytes。

第二个泛型参数是最大内联大小。增加此值允许存储更大的字符串（即，不进行分配），但也会增加结构体的整体大小。请注意，即使您将指定的最大大小设置得更大，内联也限制在 255 个字节。

示例

例如，我们可以使用这些类型创建一个与 String 具有相同大小的共享字符串类型，但内联长度可达 23 个字节，类似于其他一些 crate

# use std::rc::Rc;
# use our_string::OurString;
type MyString = OurString<Rc<str>, 23>;
assert_eq!(size_of::<MyString>(), size_of::<String>());

let a = MyString::from("hello world!");
assert_eq!(a, "hello world!");

然而，您可能注意到 Option<MyString> 比纯 MyString（与 String 不同）更大，但我们可以轻松地将一个字节的内联空间用于这种大小优化

# use std::rc::Rc;
# use our_string::OurString;
type MyString = OurString<Rc<str>, 22>;
assert_eq!(size_of::<Option<MyString>>(), size_of::<String>());

let a = MyString::from("hello world!");
assert_eq!(a, "hello world!");

在先前的示例中，我们使用 Rc<str> 而不是 Rc<String> 以避免在非内联情况下的双重间接引用。然而，Rc<str> 占用 16 个字节，而 Rc<String> 仅占用 8 个字节。因此，如果结构体的大小比可能的间接引用更重要，您可以使用类似以下的方式

# use std::rc::Rc;
# use our_string::OurString;
type MyString = OurString<Rc<String>, 15>;
assert_eq!(size_of::<MyString>(), 16);
assert_eq!(size_of::<String>(), 24);

let a = MyString::from("hello world!");
assert_eq!(a, "hello world!");