Struct TryCapturesIter

pub struct TryCapturesIter<'h, F> { /* private fields */ }

An iterator over all non-overlapping captures for a fallible search.

The iterator yields a Result<Captures, MatchError> value until no more matches could be found.

The type parameters are as follows:

The lifetime parameters come from the Input type:

When possible, prefer the iterators defined on the regex engine you're using. This tries to abstract over the regex engine and is thus a bit more unwieldy to use.

This iterator is created by Searcher::into_captures_iter.

Implementations

impl<'h, F> TryCapturesIter<'h, F>

fn infallible(self) -> CapturesIter<'h, F>

Return an infallible version of this iterator.

Any item yielded that corresponds to an error results in a panic. This is useful if your underlying regex engine is configured in a way that it is guaranteed to never return an error.

Trait Implementations

impl<'h, F> Debug for TryCapturesIter<'h, F>

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

impl<'h, F> Iterator for TryCapturesIter<'h, F> where F: FnMut(&Input<'_>, &mut Captures) -> Result<(), MatchError>,

type Item = Result<Captures, MatchError>;
fn next(&mut self) -> Option<Result<Captures, MatchError>>

Auto Trait Implementations

impl<'h, F> Freeze for TryCapturesIter<'h, F> where F: Freeze,

impl<'h, F> RefUnwindSafe for TryCapturesIter<'h, F> where F: RefUnwindSafe,

impl<'h, F> Send for TryCapturesIter<'h, F> where F: Send,

impl<'h, F> Sync for TryCapturesIter<'h, F> where F: Sync,

impl<'h, F> Unpin for TryCapturesIter<'h, F> where F: Unpin,

impl<'h, F> UnsafeUnpin for TryCapturesIter<'h, F> where F: UnsafeUnpin,

impl<'h, F> UnwindSafe for TryCapturesIter<'h, F> where F: UnwindSafe,

Blanket Implementations

impl<I> IntoIterator for TryCapturesIter<'h, F> where I: Iterator,

type Item = <I as Iterator>::Item;
type IntoIter = I;
fn into_iter(self) -> I

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

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for TryCapturesIter<'h, F> where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for TryCapturesIter<'h, F> where T: ?Sized,

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

impl<T> From<T> for TryCapturesIter<'h, F>

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for TryCapturesIter<'h, F> where U: From<T>,

fn into(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<U> for TryCapturesIter<'h, F> where U: Into<T>,

type Error = never;
fn try_from(value: U) -> Result<T, never>

impl<T, U> TryInto<U> for TryCapturesIter<'h, F> where U: TryFrom<T>,

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