Struct vec_mut_scan::VecMutScan

pub struct VecMutScan<'a, T: 'a> { /* fields omitted */ }

Forward scan over a vector with mutation and item removal.

Provides an iterator like interface over a vector which allows mutation and removal of items. Items are kept in order and every item is moved at most once, even when items are removed. Dropping the VecMutScan mid-iteration keeps remaining items in the vector.

This does not implement the iterator trait, as the returned items borrow from this (i.e. this is a streaming iterator).

The next method returns VecMutScanItem values, which auto dereference to the vector's item type but also provide a remove and replace method.

Methods

impl<'a, T: 'a> VecMutScan<'a, T>

pub fn new(vec: &mut Vec<T>) -> VecMutScan<T>

Begin a scan over a vector with mutation and item removal.

pub fn next<'s>(&'s mut self) -> Option<VecMutScanItem<'s, 'a, T>>

Advance to the next item of the vector.

This returns a reference wrapper that enables item removal (see VecMutScanItem).

Trait Implementations

impl<'a, T: 'a> Drop for VecMutScan<'a, T>

fn drop(&mut self)

Executes the destructor for this type.