Trait fallible_iterator::FallibleIterator
source · pub trait FallibleIterator {
type Item;
type Error;
Show 38 methods
fn next(&mut self) -> Result<Option<Self::Item>, Self::Error>;
fn size_hint(&self) -> (usize, Option<usize>) { ... }
fn all<F>(&mut self, f: F) -> Result<bool, Self::Error>
where
Self: Sized,
F: FnMut(Self::Item) -> bool,
{ ... }
fn and_then<F, B>(self, f: F) -> AndThen<Self, F>
where
Self: Sized,
F: FnMut(Self::Item) -> Result<B, Self::Error>,
{ ... }
fn any<F>(&mut self, f: F) -> Result<bool, Self::Error>
where
Self: Sized,
F: FnMut(Self::Item) -> bool,
{ ... }
fn by_ref(&mut self) -> &mut Self
where
Self: Sized,
{ ... }
fn chain<I>(self, it: I) -> Chain<Self, I>
where
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self: Sized,
{ ... }
fn cloned<'a, T>(self) -> Cloned<Self>
where
Self: Sized + FallibleIterator<Item = &'a T>,
T: 'a + Clone,
{ ... }
fn count(self) -> Result<usize, Self::Error>
where
Self: Sized,
{ ... }
fn collect<T>(self) -> Result<T, Self::Error>
where
T: FromFallibleIterator<Self::Item>,
Self: Sized,
{ ... }
fn enumerate(self) -> Enumerate<Self>
where
Self: Sized,
{ ... }
fn filter<F>(self, f: F) -> Filter<Self, F>
where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
{ ... }
fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F>
where
Self: Sized,
F: FnMut(Self::Item) -> Option<B>,
{ ... }
fn find<F>(&mut self, f: F) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
{ ... }
fn fuse(self) -> Fuse<Self>
where
Self: Sized,
{ ... }
fn fold<B, F>(self, init: B, f: F) -> Result<B, Self::Error>
where
Self: Sized,
F: FnMut(B, Self::Item) -> B,
{ ... }
fn iterator(self) -> Iterator<Self> ⓘ
where
Self: Sized,
{ ... }
fn last(self) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
{ ... }
fn map<B, F>(self, f: F) -> Map<Self, F>
where
F: FnMut(Self::Item) -> B,
Self: Sized,
{ ... }
fn map_err<B, F>(self, f: F) -> MapErr<Self, F>
where
F: FnMut(Self::Error) -> B,
Self: Sized,
{ ... }
fn max(self) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
Self::Item: Ord,
{ ... }
fn max_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
{ ... }
fn min(self) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
Self::Item: Ord,
{ ... }
fn min_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>
where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
{ ... }
fn nth(&mut self, n: usize) -> Result<Option<Self::Item>, Self::Error> { ... }
fn peekable(self) -> Peekable<Self>
where
Self: Sized,
{ ... }
fn position<F>(&mut self, f: F) -> Result<Option<usize>, Self::Error>
where
Self: Sized,
F: FnMut(Self::Item) -> bool,
{ ... }
fn rev(self) -> Rev<Self>
where
Self: Sized + DoubleEndedFallibleIterator,
{ ... }
fn take(self, n: usize) -> Take<Self>
where
Self: Sized,
{ ... }
fn zip<I>(self, o: I) -> Zip<Self, I::IntoIter>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
{ ... }
fn cmp<I>(self, other: I) -> Result<Ordering, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self::Item: Ord,
{ ... }
fn partial_cmp<I>(self, other: I) -> Result<Option<Ordering>, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
{ ... }
fn eq<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
{ ... }
fn ne<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
{ ... }
fn lt<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
{ ... }
fn le<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
{ ... }
fn gt<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
{ ... }
fn ge<I>(self, other: I) -> Result<bool, Self::Error>
where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
{ ... }
}
Expand description
An Iterator
-like trait that allows for calculation of items to fail.
Required Associated Types§
Required Methods§
Provided Methods§
sourcefn size_hint(&self) -> (usize, Option<usize>)
fn size_hint(&self) -> (usize, Option<usize>)
Returns bounds on the remaining length of the iterator.
Specifically, the first half of the returned tuple is a lower bound and the second half is an upper bound.
For the upper bound, None
indicates that the upper bound is either
unknown or larger than can be represented as a usize
.
Both bounds assume that all remaining calls to next
succeed. That is,
next
could return an Err
in fewer calls than specified by the lower
bound.
The default implementation returns (0, None)
, which is correct for
any iterator.
sourcefn all<F>(&mut self, f: F) -> Result<bool, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
fn all<F>(&mut self, f: F) -> Result<bool, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
Determines if all elements of this iterator match a predicate.
sourcefn and_then<F, B>(self, f: F) -> AndThen<Self, F>where
Self: Sized,
F: FnMut(Self::Item) -> Result<B, Self::Error>,
fn and_then<F, B>(self, f: F) -> AndThen<Self, F>where
Self: Sized,
F: FnMut(Self::Item) -> Result<B, Self::Error>,
Returns an iterator which applies a fallible transform to the elements of the underlying iterator.
sourcefn any<F>(&mut self, f: F) -> Result<bool, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
fn any<F>(&mut self, f: F) -> Result<bool, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
Determines if any element of this iterator matches a predicate.
sourcefn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
fn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
Borrow an iterator rather than consuming it.
This is useful to allow the use of iterator adaptors that would otherwise consume the value.
sourcefn chain<I>(self, it: I) -> Chain<Self, I>where
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self: Sized,
fn chain<I>(self, it: I) -> Chain<Self, I>where
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self: Sized,
Returns an iterator which yields the elements of this iterator followed by another.
sourcefn cloned<'a, T>(self) -> Cloned<Self>where
Self: Sized + FallibleIterator<Item = &'a T>,
T: 'a + Clone,
fn cloned<'a, T>(self) -> Cloned<Self>where
Self: Sized + FallibleIterator<Item = &'a T>,
T: 'a + Clone,
Returns an iterator which clones all of its elements.
sourcefn count(self) -> Result<usize, Self::Error>where
Self: Sized,
fn count(self) -> Result<usize, Self::Error>where
Self: Sized,
Consumes the iterator, returning the number of remaining items.
sourcefn collect<T>(self) -> Result<T, Self::Error>where
T: FromFallibleIterator<Self::Item>,
Self: Sized,
fn collect<T>(self) -> Result<T, Self::Error>where
T: FromFallibleIterator<Self::Item>,
Self: Sized,
Transforms the iterator into a collection.
An Err
will be returned if any invocation of next
returns Err
.
sourcefn enumerate(self) -> Enumerate<Self>where
Self: Sized,
fn enumerate(self) -> Enumerate<Self>where
Self: Sized,
Returns an iterator which yields the current iteration count as well as the value.
sourcefn filter<F>(self, f: F) -> Filter<Self, F>where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
fn filter<F>(self, f: F) -> Filter<Self, F>where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
Returns an iterator which uses a predicate to determine which values should be yielded.
sourcefn filter_map<B, F>(self, f: F) -> FilterMap<Self, F>where
Self: Sized,
F: FnMut(Self::Item) -> Option<B>,
fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F>where
Self: Sized,
F: FnMut(Self::Item) -> Option<B>,
Returns an iterator which both filters and maps.
sourcefn find<F>(&mut self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
fn find<F>(&mut self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
F: FnMut(&Self::Item) -> bool,
Returns the first element of the iterator that matches a predicate.
sourcefn fuse(self) -> Fuse<Self>where
Self: Sized,
fn fuse(self) -> Fuse<Self>where
Self: Sized,
Returns an iterator which yields this iterator’s elements and ends after
the first Ok(None)
.
The behavior of calling next
after it has previously returned
Ok(None)
is normally unspecified. The iterator returned by this method
guarantees that Ok(None)
will always be returned.
sourcefn fold<B, F>(self, init: B, f: F) -> Result<B, Self::Error>where
Self: Sized,
F: FnMut(B, Self::Item) -> B,
fn fold<B, F>(self, init: B, f: F) -> Result<B, Self::Error>where
Self: Sized,
F: FnMut(B, Self::Item) -> B,
Applies a function over the elements of the iterator, producing a single final value.
sourcefn iterator(self) -> Iterator<Self> ⓘwhere
Self: Sized,
fn iterator(self) -> Iterator<Self> ⓘwhere
Self: Sized,
Returns a normal (non-fallible) iterator over Result<Item, Error>
.
sourcefn last(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
fn last(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
Returns the last element of the iterator.
sourcefn map<B, F>(self, f: F) -> Map<Self, F>where
F: FnMut(Self::Item) -> B,
Self: Sized,
fn map<B, F>(self, f: F) -> Map<Self, F>where
F: FnMut(Self::Item) -> B,
Self: Sized,
Returns an iterator which applies a transform to the elements of the underlying iterator.
sourcefn map_err<B, F>(self, f: F) -> MapErr<Self, F>where
F: FnMut(Self::Error) -> B,
Self: Sized,
fn map_err<B, F>(self, f: F) -> MapErr<Self, F>where
F: FnMut(Self::Error) -> B,
Self: Sized,
Returns an iterator which applies a transform to the errors of the underlying iterator.
sourcefn max(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
Self::Item: Ord,
fn max(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
Self::Item: Ord,
Returns the maximal element of the iterator.
sourcefn max_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
fn max_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
Returns the element of the iterator which gives the maximum value from the function.
sourcefn min(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
Self::Item: Ord,
fn min(self) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
Self::Item: Ord,
Returns the minimal element of the iterator.
sourcefn min_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
fn min_by_key<B, F>(self, f: F) -> Result<Option<Self::Item>, Self::Error>where
Self: Sized,
B: Ord,
F: FnMut(&Self::Item) -> B,
Returns the element of the iterator which gives the minimum value from the function.
sourcefn nth(&mut self, n: usize) -> Result<Option<Self::Item>, Self::Error>
fn nth(&mut self, n: usize) -> Result<Option<Self::Item>, Self::Error>
Returns the n
th element of the iterator.
sourcefn peekable(self) -> Peekable<Self>where
Self: Sized,
fn peekable(self) -> Peekable<Self>where
Self: Sized,
Returns an iterator that can peek at the next element without consuming it.
sourcefn position<F>(&mut self, f: F) -> Result<Option<usize>, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
fn position<F>(&mut self, f: F) -> Result<Option<usize>, Self::Error>where
Self: Sized,
F: FnMut(Self::Item) -> bool,
Returns the position of the first element of this iterator that matches a predicate.
sourcefn rev(self) -> Rev<Self>where
Self: Sized + DoubleEndedFallibleIterator,
fn rev(self) -> Rev<Self>where
Self: Sized + DoubleEndedFallibleIterator,
Returns an iterator that yields this iterator’s items in the opposite order.
sourcefn take(self, n: usize) -> Take<Self>where
Self: Sized,
fn take(self, n: usize) -> Take<Self>where
Self: Sized,
Returns an iterator that yields only the first n
values of this
iterator.
sourcefn zip<I>(self, o: I) -> Zip<Self, I::IntoIter>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
fn zip<I>(self, o: I) -> Zip<Self, I::IntoIter>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Returns an iterator that yields pairs of this iterator’s and another iterator’s values.
sourcefn cmp<I>(self, other: I) -> Result<Ordering, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self::Item: Ord,
fn cmp<I>(self, other: I) -> Result<Ordering, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Item = Self::Item, Error = Self::Error>,
Self::Item: Ord,
Lexicographically compares the elements of this iterator to that of another.
sourcefn partial_cmp<I>(self, other: I) -> Result<Option<Ordering>, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
fn partial_cmp<I>(self, other: I) -> Result<Option<Ordering>, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
Lexicographically compares the elements of this iterator to that of another.
sourcefn eq<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
fn eq<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
Determines if the elements of this iterator are equal to those of another.
sourcefn ne<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
fn ne<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialEq<I::Item>,
Determines if the elements of this iterator are not equal to those of another.
sourcefn lt<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
fn lt<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
Determines if the elements of this iterator are lexicographically less than those of another.
sourcefn le<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
fn le<I>(self, other: I) -> Result<bool, Self::Error>where
Self: Sized,
I: IntoFallibleIterator<Error = Self::Error>,
Self::Item: PartialOrd<I::Item>,
Determines if the elements of this iterator are lexicographically less than or equal to those of another.