8次发布
0.1.2 | 2023年12月20日 |
---|---|
0.1.1 | 2023年12月20日 |
0.1.0 | 2022年12月21日 |
0.0.5 | 2022年12月18日 |
0.0.1 | 2021年11月15日 |
#390 in Rust模式
每月41次下载
16KB
211 行
copstr: 使用const泛型进行容量管理的COPy STRing模块
copstr::Str
包装了一个固定大小的 u8
数组,并在其上提供了类似字符串的接口。大小由一个const泛型参数指定。
内部的 u8
数组对应于UTF-8编码的 chars
。所有函数都保证内容是有效的UTF-8,如果它们不是,则返回错误。截断仅发生在UTF-8边界处。
copstr
非常有用,当我们想要向实现 Copy
的结构体中添加字符串类型的字段,但又不想放弃这个特性时。
示例用法
use copstr;
use std::convert::TryFrom;
// Create an owned fixed-size string with size 6 *on the stack*:
let mut string = copstr::Str::<6>::try_from("string")?;
// Use it as a regular string:
println!("contents: {}", string);
// Replace the contents with another string that fits the size 6:
string.replace("str")?;
// Append a letter:
string.push('i')?;
// Instead of returning a potential error, we can instead use
// truncating methods:
string.replace_trunc("stringification");
assert_eq!(string.as_str(), "string");
// `copstr::Str` implements Deref<Target=str>, so all `str`
// methods are available:
let split = format!("{:?}", string.split_at(3));
assert_eq!(split, r#"("str", "ing")"#);
// We can add a `copstr` to a struct without having to give up the
// `Copy` trait:
#[derive(Clone, Copy)]
pub struct Mystruct {
// ...
comment: copstr::Str<10>,
}
// We can (and should) create a type alias:
type MyStr = copstr::Str::<4>;
// We can create `copstr` in const contexts:
const TEST: MyStr = MyStr::new_const("TEST");
在const上下文中,不匹配的字符串会生成编译错误。例如,以下代码无法编译
const TEST_BAD: copstr::Str<3> = copstr::Str::<3>::new_const("TEST");