Struct mutable_constant::Mc

pub struct Mc<T>(_);

A smart pointer that allows mutation on immutable values.

This uses a *mut T internally, so most internal operations are unsafe. However, thanks to Rust’s borrowing guarantees, many of these operations are safe when used publicly. The only operation that is not safe is as_defiant_mut, which creates a mutable reference in defiance of Rust’s rules.

Implementations

impl<T> Mc<T>

pub fn new(t: T) -> Mc<T>

Creates a new Mc from a value.

Example

use mutable_constant::Mc;
 
let mc = Mc::new(42);

pub unsafe fn as_defiant_mut(&self) -> &mut T

Gets a mutable reference to the inner value.

Safety

This is unsafe because the mutable reference does not obey the borrow checker. For example, a mutable reference to a Mc can be created while there is an immutable reference to the same Mc. If you do not need this specific behavior, use as_mut instead.

Example

use mutable_constant::Mc;
 
let mut mc = Mc::new(42);
 
unsafe {
    *mc.as_defiant_mut() = 43;
}

Trait Implementations

impl<T> AsMut<T> for Mc<T>

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

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T> AsRef<T> for Mc<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Clone for Mc<T>where T: Clone,

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 for Mc<T>where T: Debug,

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

Formats the value using the given formatter.

impl<T> Deref for Mc<T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<T> DerefMut for Mc<T>

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

Mutably dereferences the value.

impl<T> Display for Mc<T>where T: Display,

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

Formats the value using the given formatter.

impl<T> Drop for Mc<T>

fn drop(&mut self)

Executes the destructor for this type.