Struct cow_arc::CowArc

pub struct CowArc<T: Clone> { /* fields omitted */ }

Implementations

impl<T: Clone> CowArc<T>

pub fn new(val: T) -> CowArc<T>

Creates new CowArc value

pub fn set_val(&mut self, val: T)

Method sets new value for inner Arc value. Performs new allocation. All previous values are still available over previous clones.

Examples

use cow_arc::CowArc;
use std::ops::Deref;

let source = CowArc::new(vec![1, 2, 3]);
 
// Still shared memory
let mut changed = source.clone();
assert!(std::ptr::eq(source.deref(), changed.deref()) == true);
assert!(changed.eq(&vec![1, 2, 3]));
 
// New memory allocation
changed.set_val(vec![1, 2, 3, 4]);
assert!(std::ptr::eq(source.deref(), changed.deref()) == false);
assert!(changed.eq(&vec![1, 2, 3, 4]));

pub fn update_val<F: FnOnce(&mut T)>(&mut self, f: F)

Method updates inner Arc value by replacing it with new value. Performs new allocation. All previous values are still available over previous clones.

Examples

use cow_arc::CowArc;
use std::ops::Deref;

let source = CowArc::new(vec![1, 2, 3]);
 
// Still shared memory
let mut updated = source.clone();
assert!(std::ptr::eq(source.deref(), updated.deref()) == true);
assert!(updated.eq(&vec![1, 2, 3]));
 
// New memory allocation
updated.update_val(|val|{
       val.push(4);
});
assert!(std::ptr::eq(source.deref(), updated.deref()) == false);
assert!(updated.eq(&vec![1, 2, 3, 4]));

Trait Implementations

impl<T: Clone> Clone for CowArc<T>

fn clone(&self) -> Self

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for CowArc<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Clone> Deref for CowArc<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.