Trait nom::lib::std::convert::AsMut

pub trait AsMut<T> where
    T: ?Sized, {
    pub fn as_mut(&mut self) -> &mut T;
}

Used to do a cheap mutable-to-mutable reference conversion.

This trait is similar to AsRef but used for converting between mutable references. If you need to do a costly conversion it is better to implement From with type &mut T or write a custom function.

Note: This trait must not fail. If the conversion can fail, use a dedicated method which returns an Option<T> or a Result<T, E>.

Generic Implementations

• AsMut auto-dereferences if the inner type is a mutable reference (e.g.: foo.as_mut() will work the same if foo has type &mut Foo or &mut &mut Foo)

Examples

Using AsMut as trait bound for a generic function we can accept all mutable references that can be converted to type &mut T. Because Box<T> implements AsMut<T> we can write a function add_one that takes all arguments that can be converted to &mut u64. Because Box<T> implements AsMut<T>, add_one accepts arguments of type &mut Box<u64> as well:

fn add_one<T: AsMut<u64>>(num: &mut T) {
    *num.as_mut() += 1;
}

let mut boxed_num = Box::new(0);
add_one(&mut boxed_num);
assert_eq!(*boxed_num, 1);

Required methods

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

Performs the conversion.

Loading content...

Implementations on Foreign Types

impl AsMut<str> for str

pub fn as_mut(&mut self) -> &mut str

impl<'_, T, U> AsMut<U> for &'_ mut T where
    T: AsMut<U> + ?Sized,
    U: ?Sized, 

pub fn as_mut(&mut self) -> &mut U

impl<T, const N: usize> AsMut<[T]> for [T; N]

pub fn as_mut(&mut self) -> &mut [T]

impl<T> AsMut<[T]> for [T]

pub fn as_mut(&mut self) -> &mut [T]

impl<O, T> AsMut<BitSlice<O, T>> for BitBox<O, T> where
    O: BitOrder,
    T: BitStore, 

pub fn as_mut(&mut self) -> &mut BitSlice<O, T>

impl<O, T> AsMut<BitSlice<O, T>> for BitVec<O, T> where
    O: BitOrder,
    T: BitStore, 

pub fn as_mut(&mut self) -> &mut BitSlice<O, T>

impl<O, V> AsMut<BitSlice<O, <V as BitView>::Store>> for BitArray<O, V> where
    O: BitOrder,
    V: BitView, 

pub fn as_mut(&mut self) -> &mut BitSlice<O, <V as BitView>::Store>

impl<T> AsMut<T> for FmtUpperHex<T> where
    T: UpperHex, 

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

impl<T> AsMut<T> for FmtLowerExp<T> where
    T: LowerExp, 

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

impl<T> AsMut<T> for FmtBinary<T> where
    T: Binary, 

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

impl<T> AsMut<T> for FmtDisplay<T> where
    T: Display, 

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

impl<T> AsMut<T> for FmtLowerHex<T> where
    T: LowerHex, 

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

impl<T> AsMut<T> for FmtUpperExp<T> where
    T: UpperExp, 

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

impl<T> AsMut<T> for FmtOctal<T> where
    T: Octal, 

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

impl<T> AsMut<T> for FmtPointer<T> where
    T: Pointer, 

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

impl<A> AsMut<[<A as Array>::Item]> for ArrayVec<A> where
    A: Array, 

pub fn as_mut(&mut self) -> &mut [<A as Array>::Item]

Loading content...

Implementors

impl AsMut<str> for String

pub fn as_mut(&mut self) -> &mut str

impl<T, A> AsMut<[T]> for Vec<T, A> where
    A: Allocator, 

pub fn as_mut(&mut self) -> &mut [T]

impl<T, A> AsMut<Vec<T, A>> for Vec<T, A> where
    A: Allocator, 

pub fn as_mut(&mut self) -> &mut Vec<T, A>

impl<T, A> AsMut<T> for Box<T, A> where
    T: ?Sized,
    A: Allocator, 

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

Loading content...