Struct vec_mut_scan::VecMutScanItem

pub struct VecMutScanItem<'s, 'a, T: 'a> { /* private fields */ }

Reference wrapper that enables item removal for VecMutScan.

Implementations

impl<'s, 'a, T: 'a> VecMutScanItem<'s, 'a, T>

pub fn remove(self) -> T

Removes and returns this item from the vector.

pub fn replace(self, value: T) -> T

Replaces this item with a new value, returns the old value.

This is equivalent to assigning a new value or calling mem::replace on the mutable reference obtained by using DerefMut, but can avoid an intermediate move within the vector’s buffer.

pub fn slices(&self) -> (&[T], &[T])

Access the whole vector.

This provides access to the whole vector at any point during the scan. In general while scanning, the vector content is not contiguous, thus it is returned as two slices, a prefix and a suffix. The prefix contains all elements already visited while the suffix contains the remaining elements starting with this element.

This method is also present on the VecMutScan borrowed by this reference wrapper, allowing access without an active VecMutScanItem.

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

Access and mutate the whole vector.

This provides mutable access to the whole vector at any point during the scan. In general while scanning, the vector content is not contiguous, thus it is returned as two slices, a prefix and a suffix. The prefix contains all elements already visited while the suffix contains the remaining elements starting with this element.

This method is also present on the VecMutScan borrowed by this reference wrapper, allowing access without an active VecMutScanItem.

Trait Implementations

impl<'s, 'a, T: 'a> Deref for VecMutScanItem<'s, 'a, T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<'s, 'a, T: 'a> DerefMut for VecMutScanItem<'s, 'a, T>

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

Mutably dereferences the value.

impl<'s, 'a, T: 'a> Drop for VecMutScanItem<'s, 'a, T>

fn drop(&mut self)

Executes the destructor for this type.