基准测试结果

此基准测试于 2024年1月13日 更新，可在 此处 找到。

create_box                   28 ns/iter (+/- 3)
create_string                28 ns/iter (+/- 1)
create_mutstr                28 ns/iter (+/- 0)
replace_box_data             104 ns/iter (+/- 3)
replace_string_data          85 ns/iter (+/- 7)
replace_mutstr_data          82 ns/iter (+/- 1)

示例

您可以使用 MutStr 轻松添加新值或删除现有值。

use mutstr::mutstr;

fn main() {
  let mut result = mutstr::from("hello");
  result += " my friend"; // Add -> " my friend"
  result -= " friend"; // Remove -> " friend"
  assert_eq!(result.as_str(), "hello my");
  
  result.push(" friend friend friend"); // Add -> " friend friend friend"
  result -= (2, " friend"); // Remove(2 times) -> " friend"
  assert_eq!(result.as_str(), "hello my friend");
  
  result += String::from(" :)"); // Add -> " :)"
  assert_eq!(result.as_str(), "hello my friend :)");
}

示例

您可以从 MutStr 轻松获取一个 &str，就像使用 String 一样。

use mutstr::mutstr;

fn main() {
  let first = String::from("hello friend");
  let first_str = &*first; // String as `&str`
  let second = mutstr::from("hello friend");
  let second_str = &*second; // MutStr as `&str`
  assert_eq!(first_str, second_str);
}

示例

您可以将 MutStr 容易地用于哈希表和向量中，就像您可以使用 Box<str> 一样。

use std::collections::HashMap;
use mutstr::mutstr;

fn main() {
  let mut result = HashMap::<Box<str>, mutstr>::new();
  result.insert(Box::from("hello"), mutstr::from("friend"));
  
  let value = result.get_mut("hello").unwrap();
  *value += " :)";
  
  assert_eq!(value.as_str(), "friend :)");
}