A persistent string type with the same API as a linked-list of characters.
See the docs for memory-layout diagrams and explanations of how it all works.
unsafeThis crate is a work in progress. Specifically Not all uses of unsafe have been validated! Please don't use this for anything serious yet.
Safety audits are welcome and appreciated! I'm still quite new to writing unsafe code.
Also, this crate depends on front-vec which is also badly in need of auditing.
```rust use assert2::assert; // For nicer assertions. let icon = CharList::from("icon"); let nomicon = icon.consstr("nom"); let rustonomicon = nomicon.consstr("rusto"); let rustonomicon2 = rustonomicon.clone(); // Cloning only copys two words.
assert!(icon == "icon"); assert!(nomicon == "nomicon"); assert!(rustonomicon == "rustonomicon"); assert!(rustonomicon == rustonomicon2);
// No new allocations required (if underlying buffer capacity allows).
// Mutably prepends the &str to the buffer without shifting memory.
let thebook = rustonomicon.consstr("the ");
assert!(the_book == "the rustonomicon");
// Drop to mutably resize underlying buffer and drop(rustonomicon); drop(the_book); drop(rustonomicon2);
let janellemonae = icon.cons('b'); // Duplication required now. assert!(janellemonae == "bicon"); ```