TempRef

overview

This crate provides a type whose value remains unchanged even when accessed through a mutable reference.

features

• Automatically reset when the mutable reference is dropped
• Works in both single-threaded and multi-threaded contexts
• no_std compatible (only the unsync module)
• no dependencies

feature flags

usage

use tempref::unsync::Temp;

let data = vec![0;128];
let workspace = Temp::new(data, |d| {d.fill(0);});

assert_eq!(*workspace.borrow(), vec![0;128]);

{
    // vec.clone() is unnecessary, so repeated allocations are avoided (as long as it’s not reallocated).
    // This helps keep your program lightweight.
    let mut guard = workspace.borrow_mut();
    guard.fill(1);
    assert_eq!(*guard, vec![1;128]);
} // d.fill(0) is called here.
assert_eq!(*workspace.borrow(), vec![0;128]);

{
    let mut guard = workspace.borrow_mut();
    guard.pop();
    assert_eq!(*guard, vec![0;127]);
} // The length is not reset because the closure only resets the payload.
assert_eq!(*workspace.borrow(), vec![0;127]);

crate info

• License: MIT OR Apache-2.0
• Crate: crates.io
• Docs: docs.rs
• Repository: GitHub