#builder #cow #ram

cow_arc

CowArc can be useful for decreasing memory allocations by sharing immutable memory

3 releases

0.2.2 Mar 17, 2021
0.2.1 Feb 1, 2021
0.2.0 Feb 1, 2021

#2644 in Rust patterns

MIT license

8KB
87 lines

Purposes

CowArc can be useful for decreasing memory allocations by sharing immutable memory.

It saves some RAM by sharing immutable values between CowArc clones. Memory allocates only in case of changing value.

CowArc can be usefull for creating builders.

Examples

let source = CowArc::new(vec![1, 2, 3]);

// Still shared memory
let mut changed = cloned.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]));
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!(changed.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]));

No runtime deps