mirror of
https://github.com/leptos-rs/leptos
synced 2024-09-20 06:21:57 +00:00
31 lines
804 B
Markdown
31 lines
804 B
Markdown
This module contains the `Oco` (Owned Clones Once) smart pointer,
|
|
which is used to store immutable references to values.
|
|
This is useful for storing, for example, strings.
|
|
|
|
Imagine this as an alternative to [`Cow`] with an additional, reference-counted
|
|
branch.
|
|
|
|
```rust
|
|
use oco_ref::Oco;
|
|
use std::sync::Arc;
|
|
|
|
let static_str = "foo";
|
|
let arc_str: Arc<str> = "bar".into();
|
|
let owned_str: String = "baz".into();
|
|
|
|
fn uses_oco(value: impl Into<Oco<'static, str>>) {
|
|
let mut value = value.into();
|
|
|
|
// ensures that the value is either a reference, or reference-counted
|
|
// O(n) at worst
|
|
let clone1 = value.clone_inplace();
|
|
|
|
// these subsequent clones are O(1)
|
|
let clone2 = value.clone();
|
|
let clone3 = value.clone();
|
|
}
|
|
|
|
uses_oco(static_str);
|
|
uses_oco(arc_str);
|
|
uses_oco(owned_str);
|
|
```
|