Skip to main content

SliceIterMut

Struct SliceIterMut 

Source
pub struct SliceIterMut<'s, T> { /* private fields */ }
Expand description

๐Ÿ”„ ๐Ÿƒ A lending iterator over an exclusive slice.


๐Ÿ“ sys/mem/view

๐Ÿ“ฆ size_of::<SliceIterMut<'_, char>>() == 16 bytes / 128 bits #๏ธโƒฃ #[cfg(target_pointer_width = โ€œ32โ€)]

๐Ÿ“ฆ size_of::<SliceIterMut<'_, char>>() == 32 bytes / 256 bits #๏ธโƒฃ #[cfg(target_pointer_width = โ€œ64โ€)]


Yields &mut T references in index order.

The returned reference is tied to the temporary mutable borrow of the iterator taken by next, matching the IteratorLending contract.

ยงExamples

let mut array = [0, 1, 2, 3];
let mut it = SliceIterMut::new(&mut array);
while let Some(x) = it.next() {
    *x += 1;
}
assert_eq![array.as_slice(), &[1, 2, 3, 4]];

Implementationsยง

Sourceยง

impl<'s, T> SliceIterMut<'s, T>

Source

pub fn new(slice: &'s mut [T]) -> Self

Creates an iterator over the given exclusive slice starting at index 0.

Trait Implementationsยง

Sourceยง

impl<'s, T: Debug> Debug for SliceIterMut<'s, T>

Sourceยง

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

Formats the value using the given formatter. Read more
Sourceยง

impl<'s, T> IteratorLending for SliceIterMut<'s, T>

Sourceยง

type Item<'a> = &'a mut T where Self: 'a

The item yielded by this iterator. Read more
Sourceยง

fn next<'a>(&'a mut self) -> Option<Self::Item<'a>> โ“˜

Advances the iterator and returns the next item. Read more
Sourceยง

fn size_hint(&self) -> (usize, Option<usize>) โ“˜

Returns a size hint for the remaining items. Read more
Sourceยง

fn count(&mut self) -> usize

Consumes the iterator, returning the number of remaining items.
Sourceยง

fn advance_by(&mut self, n: usize) -> Result<(), usize> โ“˜

Advances the iterator by n steps. Read more
Sourceยง

fn nth<'a>(&'a mut self, n: usize) -> Option<Self::Item<'a>> โ“˜

Advances the iterator by n items and returns the next one.
Sourceยง

fn for_each<F>(&mut self, f: F)
where F: FnMut(Self::Item<'_>),

Applies f to each remaining item.
Sourceยง

fn inspect<F>(&mut self, f: F)
where F: FnMut(&Self::Item<'_>),

Calls f for each item before yielding it. Read more
Sourceยง

fn is_partitioned<P>(&mut self, pred: P) -> bool
where P: FnMut(&Self::Item<'_>) -> bool,

Returns true if the iterator is partitioned according to pred. Read more
Sourceยง

fn try_fold<B, E, F>(&mut self, acc: B, f: F) -> Result<B, E> โ“˜
where F: FnMut(B, Self::Item<'_>) -> Result<B, E>,

Applies f to each item, accumulating results in acc. Read more
Sourceยง

fn try_for_each<F, E>(&mut self, f: F) -> Result<(), E> โ“˜
where F: FnMut(Self::Item<'_>) -> Result<(), E>,

Applies f to each remaining item until an error occurs.
Sourceยง

fn all<P>(&mut self, pred: P) -> bool
where P: FnMut(&Self::Item<'_>) -> bool,

Returns true if all items satisfy the predicate.
Sourceยง

fn any<P>(&mut self, pred: P) -> bool
where P: FnMut(&Self::Item<'_>) -> bool,

Returns true if any item satisfies the predicate.
Sourceยง

fn position<P>(&mut self, pred: P) -> Option<usize> โ“˜
where P: FnMut(&Self::Item<'_>) -> bool,

Returns the index of the first item for which pred returns true, or None if no matching item is found.
Sourceยง

impl<'s, T> IteratorLendingDoubleEnded for SliceIterMut<'s, T>

Sourceยง

fn next_back<'a>(&'a mut self) -> Option<Self::Item<'a>> โ“˜

Returns the next item from the back of the iterator.
Sourceยง

fn nth_back<'a>(&'a mut self, n: usize) -> Option<Self::Item<'a>> โ“˜

Skips n items from the back and returns the next one. Read more
Sourceยง

fn try_rfold<B, E, F>(&mut self, acc: B, f: F) -> Result<B, E> โ“˜
where F: FnMut(B, Self::Item<'_>) -> Result<B, E>,

Reverse-direction equivalent of IteratorLending::try_fold. Read more
Sourceยง

impl<'s, T> IteratorLendingExactSize for SliceIterMut<'s, T>

Sourceยง

fn len(&self) -> usize

Returns the exact number of items remaining. Read more
Sourceยง

fn is_empty(&self) -> bool

Returns true when no more items can be produced.

Auto Trait Implementationsยง

ยง

impl<'s, T> !UnwindSafe for SliceIterMut<'s, T>

ยง

impl<'s, T> Freeze for SliceIterMut<'s, T>

ยง

impl<'s, T> RefUnwindSafe for SliceIterMut<'s, T>
where T: RefUnwindSafe,

ยง

impl<'s, T> Send for SliceIterMut<'s, T>
where T: Send,

ยง

impl<'s, T> Sync for SliceIterMut<'s, T>
where T: Sync,

ยง

impl<'s, T> Unpin for SliceIterMut<'s, T>

ยง

impl<'s, T> UnsafeUnpin for SliceIterMut<'s, T>

Blanket Implementationsยง

Sourceยง

impl<T> Any for T
where T: 'static + ?Sized,

Sourceยง

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Sourceยง

impl<T> AnyExt for T
where T: Any + ?Sized,

Sourceยง

fn type_id() -> TypeId

Returns the TypeId of Self. Read more
Sourceยง

fn type_of(&self) -> TypeId

Returns the TypeId of self. Read more
Sourceยง

fn type_name(&self) -> &'static str โ“˜

Returns the type name of self. Read more
Sourceยง

fn type_is<T: 'static>(&self) -> bool

Returns true if Self is of type T. Read more
Sourceยง

fn type_hash(&self) -> u64

Returns a deterministic hash of the TypeId of Self.
Sourceยง

fn type_hash_with<H: Hasher>(&self, hasher: H) -> u64

Returns a deterministic hash of the TypeId of Self using a custom hasher.
Sourceยง

fn as_any_ref(&self) -> &dyn Any
where Self: Sized,

Upcasts &self as &dyn Any. Read more
Sourceยง

fn as_any_mut(&mut self) -> &mut dyn Any
where Self: Sized,

Upcasts &mut self as &mut dyn Any. Read more
Sourceยง

fn as_any_box(self: Box<Self>) -> Box<dyn Any>
where Self: Sized,

Available on crate feature alloc only.
Upcasts Box<self> as Box<dyn Any>. Read more
Sourceยง

fn downcast_ref<T: 'static>(&self) -> Option<&T> โ“˜

Available on crate feature unsafe_layout and non-crate feature safe_code only.
Returns some shared reference to the inner value if it is of type T. Read more
Sourceยง

fn downcast_mut<T: 'static>(&mut self) -> Option<&mut T> โ“˜

Available on crate feature unsafe_layout and non-crate feature safe_code only.
Returns some exclusive reference to the inner value if it is of type T. Read more
Sourceยง

impl<T> Borrow<T> for T
where T: ?Sized,

Sourceยง

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Sourceยง

impl<T> BorrowMut<T> for T
where T: ?Sized,

Sourceยง

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

Mutably borrows from an owned value. Read more
Sourceยง

impl<T> ByteSized for T

Sourceยง

const BYTE_ALIGN: usize = _

The alignment of this type in bytes.
Sourceยง

const BYTE_SIZE: usize = _

The size of this type in bytes.
Sourceยง

fn byte_align(&self) -> usize

Returns the alignment of this type in bytes.
Sourceยง

fn byte_size(&self) -> usize

Returns the size of this type in bytes. Read more
Sourceยง

fn ptr_size_ratio(&self) -> [usize; 2]

Returns the size ratio between Ptr::BYTES and BYTE_SIZE. Read more
Sourceยง

impl<T> From<T> for T

Sourceยง

fn from(t: T) -> T

Returns the argument unchanged.

Sourceยง

impl<T> Hook for T

Sourceยง

fn hook<F>(self, f: F) -> Self
where F: FnOnce(&mut Self),

Hooks a mutation step into the value and returns it. Read more
Sourceยง

fn tap<F>(self, f: F) -> Self
where F: FnOnce(&Self),

Taps into the value for observation and returns it unchanged. Read more
Sourceยง

impl<T, U> Into<U> for T
where U: From<T>,

Sourceยง

fn into(self) -> U

Calls U::from(self).

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

Sourceยง

impl<T> MemExt for T
where T: ?Sized,

Sourceยง

const NEEDS_DROP: bool = _

Know whether dropping values of this type matters, in compile-time.
Sourceยง

fn mem_align_of<T>() -> usize

Returns the minimum alignment of the type in bytes. Read more
Sourceยง

fn mem_align_of_val(&self) -> usize

Returns the alignment of the pointed-to value in bytes. Read more
Sourceยง

fn mem_size_of<T>() -> usize

Returns the size of a type in bytes. Read more
Sourceยง

fn mem_size_of_val(&self) -> usize

Returns the size of the pointed-to value in bytes. Read more
Sourceยง

fn mem_copy(&self) -> Self
where Self: Copy,

Bitwise-copies a value. Read more
Sourceยง

fn mem_needs_drop(&self) -> bool

Returns true if dropping values of this type matters. Read more
Sourceยง

fn mem_drop(self)
where Self: Sized,

Drops self by running its destructor. Read more
Sourceยง

fn mem_forget(self)
where Self: Sized,

Forgets about self without running its destructor. Read more
Sourceยง

fn mem_replace(&mut self, other: Self) -> Self
where Self: Sized,

Replaces self with other, returning the previous value of self. Read more
Sourceยง

fn mem_take(&mut self) -> Self
where Self: Default,

Replaces self with its default value, returning the previous value of self. Read more
Sourceยง

fn mem_swap(&mut self, other: &mut Self)
where Self: Sized,

Swaps the value of self and other without deinitializing either one. Read more
Sourceยง

unsafe fn mem_zeroed<T>() -> T

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Sourceยง

unsafe fn mem_transmute_copy<Src, Dst>(src: &Src) -> Dst

Available on crate feature unsafe_layout only.
Returns the value of type T represented by the all-zero byte-pattern. Read more
Sourceยง

fn mem_as_bytes(&self) -> &[u8] โ“˜
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &[u8]. Read more
Sourceยง

fn mem_as_bytes_mut(&mut self) -> &mut [u8] โ“˜
where Self: Sync + Unpin,

Available on crate feature unsafe_slice only.
View a Sync + Unpin self as &mut [u8]. Read more
Sourceยง

impl<T, R> Morph<R> for T
where T: ?Sized,

Sourceยง

fn morph<F>(self, f: F) -> R
where F: FnOnce(Self) -> R, Self: Sized,

Morphs the value into a new one and returns it. Read more
Sourceยง

fn morph_ref<F>(&self, f: F) -> R
where F: FnOnce(&Self) -> R,

Morphs the value by shared reference and returns the result. Read more
Sourceยง

fn morph_mut<F>(&mut self, f: F) -> R
where F: FnOnce(&mut Self) -> R,

Morphs the value by exclusive reference and returns the result. Read more
Sourceยง

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Sourceยง

type Error = Infallible

The type returned in the event of a conversion error.
Sourceยง

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

Performs the conversion.
Sourceยง

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Sourceยง

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Sourceยง

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

Performs the conversion.