0.1.2 - This version may not be safe as it has not been updated for a long time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform
Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.
BSD-2-Clause - BSD 2-Clause "Simplified" LicenseThis library provides interior mutability that can be borrowed
as plain immutable references &T in exchange for the write-once,
read-many restriction.
Unlike std::cell::Cell or std::cell::RefCell, a plain immutable
reference &T can be taken from MutOnce<T>. Once an immutable
reference is taken, the value can never be mutated (even after all
references are dropped).
The use cases include caching getter and delayed evaluation.
Run "cargo doc" in the source directory to generate the API reference. It is also available online at https://docs.rs/mutate_once.
An example follows:
struct Container {
expensive: MutOnce<String>,
}
impl Container {
fn expensive(&self) -> &str {
if !self.expensive.is_fixed() {
let mut ref_mut = self.expensive.get_mut();
*ref_mut += "expensive";
// Drop `ref_mut` before calling `get_ref`.
}
// A plain reference can be returned to the caller
// unlike `Cell` or `RefCell`.
self.expensive.get_ref()
}
}
let container = Container { expensive: MutOnce::new(String::new()) };
assert_eq!(container.expensive(), "expensive");