Struct Mut 

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

A Clone-once wrapper.

Mut allows passing types like &mut T safely. Mut implements a dummy Clone that allows being cloned exactly once. This allows passing non-Clone types by moving them between Muts. Mut can be thought of a bit like Option. Mut contains a value and when it is Cloned the value inside is moved to the new Mut leaving None in the old Mut. This approach has the disadvantage that the uniqueness check becomes a runtime panic.

Panics

Mut will panic in any of the following situations:

1. if it is Clone::cloned more than once
2. if the inner value is accessed after a Clone

Example

fn f(mut y: Mut<&mut i32>, x: i32) {
    **y += 2 * x;
}

let x: i32 = 42;
let mut y: i32 = 31;

magic_args::apply(f, (x, Mut::from(&mut y)));
assert_eq!(y, 115);

Implementations

impl<T> Mut<T>

pub fn into_inner(self) -> T

Destruct this Mut and get the value inside.

Panics

See: type-level panic docs.

Trait Implementations

impl<T> AsMut<T> for Mut<T>

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

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

impl<T> AsMut<T> for Mut<&mut T>

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

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

impl<T> AsMut<T> for Mut<&mut &mut T>

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

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

impl<T> AsMut<T> for Mut<&mut &mut &mut 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 Mut<T>

fn as_ref(&self) -> &T

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

impl<T> AsRef<T> for Mut<&mut T>

fn as_ref(&self) -> &T

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

impl<T> AsRef<T> for Mut<&mut &mut T>

fn as_ref(&self) -> &T

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

impl<T> AsRef<T> for Mut<&mut &mut &mut T>

fn as_ref(&self) -> &T

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

impl<T> Borrow<T> for Mut<T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T> Borrow<T> for Mut<&mut T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T> Borrow<T> for Mut<&mut &mut T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T> Borrow<T> for Mut<&mut &mut &mut T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T> BorrowMut<T> for Mut<T>

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

Mutably borrows from an owned value.

impl<T> BorrowMut<T> for Mut<&mut T>

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

Mutably borrows from an owned value.

impl<T> BorrowMut<T> for Mut<&mut &mut T>

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

Mutably borrows from an owned value.

impl<T> BorrowMut<T> for Mut<&mut &mut &mut T>

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

Mutably borrows from an owned value.

impl<T> Clone for Mut<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Deref for Mut<T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<T> DerefMut for Mut<T>

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

Mutably dereferences the value.

impl<T> From<T> for Mut<T>

fn from(value: T) -> Self

Converts to this type from the input type.