Struct Alc

pub struct Alc<T: Clone>(/* private fields */);

Alc is a thread-safe LazyClone wrapper, to provide lazy cloning for any data that doesn’t implement LazyClone and need thread-safety

If you’re able to implement LazyClone for the data that you need, do it, if not, use this wrapper

Implementations

impl<T: Clone> Alc<T>

pub fn new(value: T) -> Self

Creates a new Alc from a value

pub fn read(&self) -> &T

Takes a reference of the lazy cloned value

pub fn read_mut(&mut self) -> &mut T

Ensures that the lazily cloned value is mutable and returns a mutable reference to it

pub fn write(&mut self, value: T)

Replaces the cloned value by another

Does not affect any value lazily cloned from this value

pub fn take(&self) -> T

Does an actual clone of the contained value

This clone may be expensive

pub fn ptr_eq(&self, other: &Self) -> bool

Checks if two Alc are pointing to the same data

pub unsafe fn destroy(self) -> T

Unwraps the lazy clone and returns the inner data in O(1). But it only works if the Alc hasn’t been lazily cloned, otherwise it panics

Panics

If the struct is lazily clonning other structures or if some one is lazily cloning the structure

pub fn unwrap(self) -> T

Unwraps the lazy clone and returns the inner data in O(1) if the Alc is mutable, otherwise performs a clone.

Trait Implementations

impl<T: Clone> Borrow<T> for Alc<T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T: Clone> BorrowMut<T> for Alc<T>

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value.

impl<T: Clone> Clone for Alc<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<T: Clone> DerefMut for Alc<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Clone> From<T> for Alc<T>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: Clone> LazyClone for Alc<T>

fn lazy(&self) -> Self

The O(1) lazy-clone method. Useful for cloning data that doesn’t necessarily need to be mutated.

fn eager(&self) -> Self

A non-lazy cloning method. Useful for cloning data that is known to modified

fn is_mutable(&self) -> bool

Checks if the structure can be mutated with no side effects