Struct Lc

pub struct Lc<T>(/* private fields */);

Lc is a LazyClone wrapper, to provide lazy cloning for any data that doesn’t implement LazyClone trait

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

Implementations

impl<T: Clone> Lc<T>

pub fn new(value: T) -> Self

Creates a new Lc from a value

pub fn read(&self) -> &T

Returns a reference to 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 Lc 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 Lc 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 Lc is mutable, otherwise performes an clone.

Trait Implementations

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

fn borrow(&self) -> &T

Immutably borrows from an owned value.

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

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

Mutably borrows from an owned value.

impl<T: Clone> Clone for Lc<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> Debug for Lc<T>

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

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

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

Mutably dereferences the value.

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

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: Clone> LazyClone for Lc<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