23 releases (14 stable)
new 1.3.3 | Oct 19, 2024 |
---|---|
1.3.1 | May 29, 2021 |
1.3.0 | Apr 6, 2020 |
1.2.3 | Dec 4, 2018 |
0.3.2 | Mar 21, 2017 |
#195 in Concurrency
200 downloads per month
Used in 5 crates
(2 directly)
33KB
378 lines
Thread-safe reference-counted null-terminated strings.
This crate provides a space efficient mechanism for storing immutable strings. The best illustration of this is to go over the alternatives:
// &str:
// - content must be known at compile time or leaked for owned use (`&'static str`)
// + can be shared between threads
// + space overhead is 2*usize (fat pointer to the string)
let s = "foobar";
// String
// + can be created at runtime
// - cannot be shared between threads (except with Clone)
// - space overhead of 3*usize (Vec capacity and len + pointer to bytes)
// - accessing string requires two pointer derefs
let s = format!("foobar");
// CString:
// * mostly same as String
// * space overhead is 2*usize (uses Box<[u8]> internally)
// - cannot contain internal \0 bytes
use std::ffi::CString;
let s = CString::new("foobar").unwrap();
// CStr:
// + space overhead is nominally just the pointer (1*usize),
// but in practice it also includes the length at the time of writing:
// https://github.com/rust-lang/rust/blob/b27f33a4d9c42ee6b5347a75a8a990a883437da9/library/core/src/ffi/c_str.rs#L104-L107
// - hard to construct
// - cannot contain internal \0 bytes
// - generally cannot be shared between threds (lifetime usually not 'static)
use std::ffi::CStr;
let s: &CStr = &*s;
// Arc<String>:
// + can be created at runtime
// + can be shared between threads
// - space overhead is 7*usize:
// - pointer to Arc
// - weak count
// - strong count
// - pointer to String
// - String overhead (3*usize)
use std::sync::Arc;
let s = ArcCStr::try_from(format!("foobar")).unwrap();
// Arc<str>:
// + can be created at runtime
// + can be shared between threads
// - space overhead is 4*usize:
// - pointer to Arc
// - str length
// - weak count
// - strong count
let s: Arc<str> = Arc::from("foobar");
// Arc<CStr>:
// + can be created at runtime
// + can be shared between threads
// - space overhead is 4*usize:
// - pointer to Arc
// - CStr length
// - weak count
// - strong count
// - cannot contain internal \0 bytes
let s: Arc<CStr> = Arc::from(CStr::from_bytes_with_nul(b"foobar\0").unwrap());
// ArcCStr:
// + can be created at runtime
// + can be shared between threads
// - space overhead is 2*usize (pointer + strong count)
// - cannot contain internal \0 bytes
use arccstr::ArcCStr;
let s = ArcCStr::try_from("foobar").unwrap();
See the ArcCStr
documentation for more details.
Dependencies
~110–340KB