Expand description

This crate provides a Cell type (like the standard library’s Cell) with methods for safely mutating and inspecting the inner value by reference (with and with_mut).

For Copy types, this is implemented with get and set, but through an extension trait, this crate provides those same operations for types that are Default but not Copy. A get method is also available for types that are both Default and Clone.

This crate depends only on core, so it can be used inside no_std environments.

Example

use cell_ref::{Cell, CellExt};

let c1 = Cell::new(2_u8);
c1.with_mut(|x| *x += 3);
assert!(c1.get() == 5);

let c2 = Cell::new(vec![1, 2, 3]);
c2.with_mut(|v| v.push(4)); // Works even though `Vec` isn't `Copy`
assert_eq!(c2.with(Vec::len), 4);
let v = c2.get(); // Clones the vector

Structs

A Cell type with methods for by-reference mutation and inspection.

Traits

Provides additional methods for non-Copy types.