Struct Scanner

pub struct Scanner<T, I> { /* private fields */ }

Helper that allows using Predicates rather than closures to find matching elements, and provides more informative error messages.

Returned by the ScanExt methods; see its docs for more details.

Implementations

impl<T, I> Scanner<T, I>

where I: Iterator, I::Item: Debug,

pub fn single<P: Predicate<I::Item> + ?Sized>(self, predicate: &P) -> I::Item

Finds the single item matching the predicate.

Panics

Panics with an informative message if no items, or multiple items match the predicate.

pub fn first<P: Predicate<I::Item> + ?Sized>(self, predicate: &P) -> I::Item

Finds the first item matching the predicate.

Panics

Panics with an informative message if no items match the predicate.

pub fn all<P: Predicate<I::Item> + ?Sized>(self, predicate: &P)

Checks that all of the items match the predicate.

Panics

Panics with an informative message if any of items does not match the predicate.

pub fn none<P: Predicate<I::Item> + ?Sized>(self, predicate: &P)

Checks that none of the items match the predicate.

Panics

Panics with an informative message if any of items match the predicate.

impl<T, I> Scanner<T, I>

where I: DoubleEndedIterator, I::Item: Debug,

pub fn last<P: Predicate<I::Item> + ?Sized>(self, predicate: &P) -> I::Item

Finds the last item matching the predicate.

Panics

Panics with an informative message if no items match the predicate.

Trait Implementations

impl<T: Clone, I> Clone for Scanner<T, I>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug, I: Debug> Debug for Scanner<T, I>

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

Formats the value using the given formatter.

impl<T: Copy, I> Copy for Scanner<T, I>