impl<'a, T> IterMut<'a, T>

fn into_slice(self: Self) -> &'a mut [T]

Views the underlying data as a subslice of the original data.

To avoid creating &mut references that alias, this is forced to consume the iterator.

Examples

Basic usage:

// First, we need a slice to call the `iter_mut` method on:
let mut slice = &mut [1, 2, 3];

// Then we call `iter_mut` on the slice to get the `IterMut` struct:
let mut iter = slice.iter_mut();
// Now, we call the `next` method to remove the first element of the iterator,
// unwrap and dereference what we get from `next` and increase its value by 1:
*iter.next().unwrap() += 1;
// Here the iterator does not contain the first element of the slice any more,
// so `into_slice` only returns the last two elements of the slice,
// and so this prints "[2, 3]":
println!("{:?}", iter.into_slice());
// The underlying slice still contains three elements, but its first element
// was increased by 1, so this prints "[2, 2, 3]":
println!("{:?}", slice);

fn as_slice(self: &Self) -> &[T]

Views the underlying data as a subslice of the original data.

Examples

Basic usage:

// First, we need a slice to call the `iter_mut` method on:
let slice = &mut [1, 2, 3];

// Then we call `iter_mut` on the slice to get the `IterMut` iterator:
let mut iter = slice.iter_mut();
// Here `as_slice` still returns the whole slice, so this prints "[1, 2, 3]":
println!("{:?}", iter.as_slice());

// Now, we call the `next` method to remove the first element from the iterator
// and increment its value:
*iter.next().unwrap() += 1;
// Here the iterator does not contain the first element of the slice any more,
// so `as_slice` only returns the last two elements of the slice,
// and so this prints "[2, 3]":
println!("{:?}", iter.as_slice());

// The underlying slice still contains three elements, but its first element
// was increased by 1, so this prints "[2, 2, 3]":
println!("{:?}", slice);

fn as_mut_slice(self: &mut Self) -> &mut [T]

Views the underlying data as a mutable subslice of the original data.

Examples

Basic usage:

#![feature(slice_iter_mut_as_mut_slice)]

let mut slice: &mut [usize] = &mut [1, 2, 3];

// First, we get the iterator:
let mut iter = slice.iter_mut();
// Then, we get a mutable slice from it:
let mut_slice = iter.as_mut_slice();
// So if we check what the `as_mut_slice` method returned, we have "[1, 2, 3]":
assert_eq!(mut_slice, &mut [1, 2, 3]);

// We can use it to mutate the slice:
mut_slice[0] = 4;
mut_slice[2] = 5;

// Next, we can move to the second element of the slice, checking that
// it yields the value we just wrote:
assert_eq!(iter.next(), Some(&mut 4));
// Now `as_mut_slice` returns "[2, 5]":
assert_eq!(iter.as_mut_slice(), &mut [2, 5]);

impl<'a, T> DoubleEndedIterator for IterMut<'a, T>

fn next_back(self: &mut Self) -> Option<&'a mut T>

fn nth_back(self: &mut Self, n: usize) -> Option<&'a mut T>

fn advance_back_by(self: &mut Self, n: usize) -> Result<(), NonZero<usize>>

impl<'a, T> Freeze for IterMut<'a, T>

impl<'a, T> Iterator for IterMut<'a, T>

fn next(self: &mut Self) -> Option<&'a mut T>

fn next_chunk<N: usize>(self: &mut Self) -> Result<[&'a mut T; N], IntoIter<&'a mut T, N>>

fn size_hint(self: &Self) -> (usize, Option<usize>)

fn count(self: Self) -> usize

fn nth(self: &mut Self, n: usize) -> Option<&'a mut T>

fn advance_by(self: &mut Self, n: usize) -> Result<(), NonZero<usize>>

fn last(self: Self) -> Option<&'a mut T>

fn fold<B, F>(self: Self, init: B, f: F) -> B
where
    F: FnMut(B, <Self as >::Item) -> B

fn for_each<F>(self: Self, f: F)
where
    Self: Sized,
    F: FnMut(<Self as >::Item)

fn all<F>(self: &mut Self, f: F) -> bool
where
    Self: Sized,
    F: FnMut(<Self as >::Item) -> bool

fn any<F>(self: &mut Self, f: F) -> bool
where
    Self: Sized,
    F: FnMut(<Self as >::Item) -> bool

fn find<P>(self: &mut Self, predicate: P) -> Option<<Self as >::Item>
where
    Self: Sized,
    P: FnMut(&<Self as >::Item) -> bool

fn find_map<B, F>(self: &mut Self, f: F) -> Option<B>
where
    Self: Sized,
    F: FnMut(<Self as >::Item) -> Option<B>

fn position<P>(self: &mut Self, predicate: P) -> Option<usize>
where
    Self: Sized,
    P: FnMut(<Self as >::Item) -> bool

fn rposition<P>(self: &mut Self, predicate: P) -> Option<usize>
where
    P: FnMut(<Self as >::Item) -> bool,
    Self: Sized + ExactSizeIterator + DoubleEndedIterator

impl<'a, T> RefUnwindSafe for IterMut<'a, T>

impl<'a, T> Unpin for IterMut<'a, T>

impl<'a, T> UnsafeUnpin for IterMut<'a, T>

impl<'a, T> UnwindSafe for IterMut<'a, T>

impl<I> IntoIterator for IterMut<'a, T>

fn into_iter(self: Self) -> I

impl<T> Any for IterMut<'a, T>

fn type_id(self: &Self) -> TypeId

impl<T> AsRef for IterMut<'_, T>

fn as_ref(self: &Self) -> &[T]

impl<T> Borrow for IterMut<'a, T>

fn borrow(self: &Self) -> &T

impl<T> BorrowMut for IterMut<'a, T>

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

impl<T> Default for IterMut<'_, T>

fn default() -> Self

Creates an empty slice iterator.

# use core::slice::IterMut;
let iter: IterMut < '_, u8 > = Default::default();
assert_eq!(iter.len(), 0);

impl<T> ExactSizeIterator for IterMut<'_, T>

fn len(self: &Self) -> usize

fn is_empty(self: &Self) -> bool

impl<T> From for IterMut<'a, T>

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FusedIterator for IterMut<'_, T>

impl<T> TrustedLen for IterMut<'_, T>

impl<T, U> Into for IterMut<'a, T>

fn into(self: Self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

impl<T, U> TryFrom for IterMut<'a, T>

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto for IterMut<'a, T>

fn try_into(self: Self) -> Result<U, <U as TryFrom<T>>::Error>

impl<T: Send> Send for IterMut<'_, T>

impl<T: Sync> Sync for IterMut<'_, T>

impl<T: fmt::Debug> Debug for IterMut<'_, T>

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