Struct FallibleOnce 

pub struct FallibleOnce<'a, E, L>
where
    L: ?Sized + for<'all> FallibleLending<'all>,
{ /* private fields */ }

A fallible lender that yields an element exactly once.

This struct is created by the fallible_once() function.

similar to core::iter::Once.

Trait Implementations

impl<'a, E, L> Clone for FallibleOnce<'a, E, L>

where L: ?Sized + for<'all> FallibleLending<'all>, E: Clone, FallibleLend<'a, L>: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, E, L> Debug for FallibleOnce<'a, E, L>

where L: ?Sized + for<'all> FallibleLending<'all>, E: Debug, FallibleLend<'a, L>: Debug,

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

Formats the value using the given formatter.

impl<'a, E, L> DoubleEndedFallibleLender for FallibleOnce<'a, E, L>

where E: 'a, L: ?Sized + for<'all> FallibleLending<'all>,

fn next_back(&mut self) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

fn advance_back_by( &mut self, n: usize, ) -> Result<Option<NonZeroUsize>, Self::Error>

fn nth_back( &mut self, n: usize, ) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

fn try_rfold<B, F, R>(&mut self, init: B, f: F) -> Result<R, Self::Error>

where F: FnMut(B, FallibleLend<'_, Self>) -> Result<R, Self::Error>, R: Try<Output = B>,

fn rfold<B, F>(self, init: B, f: F) -> Result<B, Self::Error>

where Self: Sized, F: FnMut(B, FallibleLend<'_, Self>) -> Result<B, Self::Error>,

fn rfind<P>( &mut self, predicate: P, ) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

where Self: Sized, P: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

impl<'a, E, L> FallibleLender for FallibleOnce<'a, E, L>

where E: 'a, L: ?Sized + for<'all> FallibleLending<'all>,

type Error = E

The error type.

fn next(&mut self) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

Yield the next lend, if any, of the lender. Returns Ok(None) when iteration is finished. The behavior of calling this method after a previous call has returned Ok(None) or Err is implementation defined.

fn size_hint(&self) -> (usize, Option<usize>)

Get the estimated minimum and maximum length of the lender. 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.

fn next_chunk(&mut self, chunk_size: usize) -> Chunk<'_, Self>

where Self: Sized,

Take the next len lends of the lender with temporary lender Chunk. This is equivalent to cloning the lender and calling take(len) on it.

fn count(self) -> Result<usize, Self::Error>

where Self: Sized,

Count the number of lends in the lender by consuming it until the lender yields Ok(None) or Err(_).

fn last<'call>( &'call mut self, ) -> Result<Option<FallibleLend<'call, Self>>, Self::Error>

where Self: Sized,

Returns the last element of the iterator.

fn advance_by(&mut self, n: usize) -> Result<Option<NonZeroUsize>, Self::Error>

Advance the lender by n lends. If the lender does not have enough lends, return the number of lends left.

fn nth( &mut self, n: usize, ) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

Yield the nth lend of the lender, if any, by consuming it. If the lender does not have enough lends, returns None.

fn step_by(self, step: usize) -> StepBy<Self>

where Self: Sized,

Skip step - 1 lends between each lend of the lender.

fn chain<U>( self, other: U, ) -> Chain<Self, <U as IntoFallibleLender>::FallibleLender>

where Self: Sized, U: IntoFallibleLender + for<'all> FallibleLending<'all, Lend = FallibleLend<'all, Self>>,

Chain the lender with another lender of the same type.

fn zip<U: IntoFallibleLender>( self, other: U, ) -> Zip<Self, <U as IntoFallibleLender>::FallibleLender>

where Self: Sized,

Zip the lender with another lender of the same or different type.

fn intersperse<'call>( self, separator: FallibleLend<'call, Self>, ) -> FallibleIntersperse<'call, Self>

where Self: Sized, for<'all> FallibleLend<'all, Self>: Clone,

Intersperse each lend of this lender with the given seperator.

fn intersperse_with<'call, G>( self, separator: G, ) -> FallibleIntersperseWith<'call, Self, G>

where Self: Sized, G: FnMut() -> Result<FallibleLend<'call, Self>, Self::Error>,

Intersperse each lend of this lender with the seperator produced by the given function.

fn map<F>(self, f: F) -> Map<Self, F>

where Self: Sized, F: for<'all> FnMutHKARes<'all, FallibleLend<'all, Self>, Self::Error>,

Map each lend of this lender using the given function.

fn map_err<E, F>(self, f: F) -> MapErr<E, Self, F>

where Self: Sized, F: FnMut(Self::Error) -> E,

Map the error of this lender using the given function.

fn map_into_iter<O, F>(self, f: F) -> MapIntoIter<Self, O, F>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<O, Self::Error>,

Map each lend of this lender into an owned value using the given function.

fn for_each<F>(self, f: F) -> Result<(), Self::Error>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<(), Self::Error>,

Call the given function with each lend of this lender.

fn filter<P>(self, predicate: P) -> Filter<Self, P>

where Self: Sized, P: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Filter this lender using the given predicate.

fn filter_map<F>(self, f: F) -> FilterMap<Self, F>

where Self: Sized, F: for<'all> FnMutHKAResOpt<'all, FallibleLend<'all, Self>, Self::Error>,

Filter and map this lender using the given function.

fn enumerate(self) -> Enumerate<Self>

where Self: Sized,

Enumerate this lender. Each lend is paired with its zero-based index.

fn peekable<'call>(self) -> FalliblePeekable<'call, Self>

where Self: Sized,

Make this lender peekable, so that it is possible to peek at the next lend without consuming it.

fn skip_while<P>(self, predicate: P) -> SkipWhile<Self, P>

where Self: Sized, P: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Skip the first contiguous sequence lends of this lender that satisfy the given predicate.

fn take_while<P>(self, predicate: P) -> TakeWhile<Self, P>

where Self: Sized, P: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Take the first contiguous sequence lends of this lender that satisfy the given predicate.

fn map_while<P>(self, predicate: P) -> MapWhile<Self, P>

where Self: Sized, P: for<'all> FnMutHKAResOpt<'all, FallibleLend<'all, Self>, Self::Error>,

Map this lender using the given function while it returns Some.

fn skip(self, n: usize) -> Skip<Self>

where Self: Sized,

Skip the first n lends of this lender.

fn take(self, n: usize) -> Take<Self>

where Self: Sized,

Take the first n lends of this lender.

fn scan<St, F>(self, initial_state: St, f: F) -> Scan<Self, St, F>

where Self: Sized, F: for<'all> FnMutHKAResOpt<'all, (&'all mut St, FallibleLend<'all, Self>), Self::Error>,

Documentation is incomplete. Refer to Iterator::scan for more information.

fn flat_map<'call, F>(self, f: F) -> FallibleFlatMap<'call, Self, F>

where Self: Sized, F: for<'all> FnMutHKARes<'all, FallibleLend<'all, Self>, Self::Error>, for<'all> <F as FnMutHKARes<'all, FallibleLend<'all, Self>, Self::Error>>::B: IntoFallibleLender<Error = Self::Error>,

Documentation is incomplete. Refer to Iterator::flat_map for more information

fn flatten<'call>(self) -> FallibleFlatten<'call, Self>

where Self: Sized, for<'all> FallibleLend<'all, Self>: IntoFallibleLender<Error = Self::Error>,

Documentation is incomplete. Refer to Iterator::flatten for more information

fn fuse(self) -> Fuse<Self>

where Self: Sized,

Documentation is incomplete. Refer to Iterator::fuse for more information

fn inspect<F>(self, f: F) -> Inspect<Self, F>

where Self: Sized, F: FnMut(&FallibleLend<'_, Self>) -> Result<(), Self::Error>,

Documentation is incomplete. Refer to Iterator::inspect for more information

fn mutate<F>(self, f: F) -> Mutate<Self, F>

where Self: Sized, F: FnMut(&mut FallibleLend<'_, Self>) -> Result<(), Self::Error>,

Mutate each lend with the given function.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Documentation is incomplete. Refer to Iterator::by_ref for more information

fn collect<B>(self) -> Result<B, (B, Self::Error)>

where Self: Sized, for<'all> B: FromLender<NonFallibleAdapter<'all, Self>>,

Transforms the iterator into a collection. If any invocation of next returns Err, returns the collection built from values yielded successfully, together with the error.

fn try_collect<'a, B, T>(&'a mut self) -> Result<T, (T, Self::Error)>

where Self: Sized, for<'all> FallibleLend<'all, Self>: Try, for<'all> <FallibleLend<'all, Self> as Try>::Residual: Residual<B, TryType = T>, for<'b, 'c, 'd> B: FromLender<FallibleTryShuntAdapter<'b, 'c, 'd, 'a, Self>>,

Transforms the iterator into a collection. If any invocation of next returns Err, returns the collection built from values yielded successfully, together with the error.

fn collect_into<E>( self, collection: &mut E, ) -> Result<&mut E, (&mut E, Self::Error)>

where Self: Sized, for<'all> E: ExtendLender<NonFallibleAdapter<'all, Self>>,

Transforms the iterator into a collection. If any invocation of next returns Err, returns the collection built from values yielded successfully, together with the error.

fn partition<'this, A, E, F>(self, f: F) -> Result<(E, E), Self::Error>

where Self: Sized + 'this, E: Default + ExtendLender<NonFallibleAdapter<'this, Self>>, F: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::partition for more information

fn is_partitioned<P>(self, predicate: P) -> Result<bool, Self::Error>

where Self: Sized, P: FnMut(FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::is_partitioned for more information

fn try_fold<B, F, R>(&mut self, init: B, f: F) -> Result<R, Self::Error>

where F: FnMut(B, FallibleLend<'_, Self>) -> Result<R, Self::Error>, R: Try<Output = B>,

Documentation is incomplete. Refer to Iterator::try_fold for more information

fn try_for_each<F, R>(&mut self, f: F) -> Result<R, Self::Error>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<R, Self::Error>, R: Try<Output = ()>,

Documentation is incomplete. Refer to Iterator::try_for_each for more information

fn fold<B, F>(self, init: B, f: F) -> Result<B, Self::Error>

where Self: Sized, F: FnMut(B, FallibleLend<'_, Self>) -> Result<B, Self::Error>,

Documentation is incomplete. Refer to Iterator::fold for more information

fn reduce<T, F>(self, f: F) -> Result<Option<T>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(T, FallibleLend<'_, Self>) -> Result<T, Self::Error>,

Documentation is incomplete. Refer to Iterator::reduce for more information

fn try_reduce<T, F, R>( self, f: F, ) -> Result<ChangeOutputType<R, Option<T>>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(T, FallibleLend<'_, Self>) -> Result<R, Self::Error>, R: Try<Output = T>, R::Residual: Residual<Option<T>>,

Documentation is incomplete. Refer to Iterator::try_reduce for more information

fn all<F>(&mut self, f: F) -> Result<bool, Self::Error>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::all for more information

fn any<F>(&mut self, f: F) -> Result<bool, Self::Error>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::any for more information

fn find<P>( &mut self, predicate: P, ) -> Result<Option<FallibleLend<'_, Self>>, Self::Error>

where P: FnMut(&FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::find for more information

fn find_map<'a, F>( &'a mut self, f: F, ) -> Result<Option<<F as FnMutHKAResOpt<'a, FallibleLend<'a, Self>, Self::Error>>::B>, Self::Error>

where Self: Sized, F: for<'all> FnMutHKAResOpt<'all, FallibleLend<'all, Self>, Self::Error>,

Documentation is incomplete. Refer to Iterator::find_map for more information

fn try_find<F, R>( &mut self, f: F, ) -> Result<ChangeOutputType<R, Option<FallibleLend<'_, Self>>>, Self::Error>

where Self: Sized, F: FnMut(&FallibleLend<'_, Self>) -> Result<R, Self::Error>, R: Try<Output = bool>, for<'all> R::Residual: Residual<Option<FallibleLend<'all, Self>>>,

Documentation is incomplete. Refer to Iterator::try_find for more information

fn position<P>(&mut self, predicate: P) -> Result<Option<usize>, Self::Error>

where Self: Sized, P: FnMut(FallibleLend<'_, Self>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::position for more information

fn max<T>(self) -> Result<Option<T>, Self::Error>

where Self: Sized, T: for<'all> PartialOrd<FallibleLend<'all, Self>>, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>,

Documentation is incomplete. Refer to Iterator::max for more information

fn min<T>(self) -> Result<Option<T>, Self::Error>

where Self: Sized, T: for<'all> PartialOrd<FallibleLend<'all, Self>>, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>,

Documentation is incomplete. Refer to Iterator::min for more information

fn max_by_key<B: Ord, T, F>(self, f: F) -> Result<Option<T>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(&T) -> Result<B, Self::Error>,

Documentation is incomplete. Refer to Iterator::max_by_key for more information

fn max_by<T, F>(self, compare: F) -> Result<Option<T>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(&T, &FallibleLend<'_, Self>) -> Result<Ordering, Self::Error>,

Documentation is incomplete. Refer to Iterator::max_by for more information

fn min_by_key<B: Ord, T, F>(self, f: F) -> Result<Option<T>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(&T) -> Result<B, Self::Error>,

Documentation is incomplete. Refer to Iterator::min_by_key for more information

fn min_by<T, F>(self, compare: F) -> Result<Option<T>, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(&T, &FallibleLend<'_, Self>) -> Result<Ordering, Self::Error>,

Documentation is incomplete. Refer to Iterator::min_by for more information

fn rev(self) -> Rev<Self>

where Self: Sized + DoubleEndedFallibleLender,

Documentation is incomplete. Refer to Iterator::rev for more information

fn unzip<ExtA, ExtB>(self) -> Result<(ExtA, ExtB), Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: TupleLend<'all>, ExtA: Default + for<'this> ExtendLender<NonFallibleAdapter<'this, <FirstShunt<Self> as IntoFallibleLender>::FallibleLender>>, ExtB: Default + for<'this> ExtendLender<NonFallibleAdapter<'this, <SecondShunt<Self> as IntoFallibleLender>::FallibleLender>>,

Documentation is incomplete. Refer to Iterator::unzip for more information

fn copied<T>(self) -> Copied<Self>

where Self: Sized + for<'all> FallibleLending<'all, Lend = &'all T>, T: Copy,

Documentation is incomplete. Refer to Iterator::copied for more information.

fn cloned<T>(self) -> Cloned<Self>

where Self: Sized + for<'all> FallibleLending<'all, Lend = &'all T>, T: Clone,

Documentation is incomplete. Refer to Iterator::cloned for more information.

fn owned(self) -> Owned<Self>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned,

Turn this FallibleLender into a FallibleIterator.

fn cycle(self) -> Cycle<Self>

where Self: Sized + Clone,

Documentation is incomplete. Refer to Iterator::cycle for more information

fn sum<S>(self) -> Result<S, Self::Error>

where Self: Sized, S: SumFallibleLender<Self>,

Documentation is incomplete. Refer to Iterator::sum for more information

fn product<P>(self) -> Result<P, Self::Error>

where Self: Sized, P: ProductFallibleLender<Self>,

Documentation is incomplete. Refer to Iterator::product for more information

fn cmp<L>(self, other: L) -> Result<Ordering, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, L::FallibleLender: for<'all> FallibleLending<'all, Lend = FallibleLend<'all, Self>>, for<'all> FallibleLend<'all, Self>: Ord, Self: Sized,

Documentation is incomplete. Refer to Iterator::cmp for more information

fn cmp_by<L, F>(self, other: L, cmp: F) -> Result<Ordering, Self::Error>

where Self: Sized, L: IntoFallibleLender<Error = Self::Error>, F: for<'all> FnMut(FallibleLend<'all, Self>, FallibleLend<'all, L::FallibleLender>) -> Result<Ordering, Self::Error>,

Documentation is incomplete. Refer to Iterator::cmp_by for more information

fn partial_cmp<L>(self, other: L) -> Result<Option<Ordering>, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialOrd<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::partial_cmp for more information

fn partial_cmp_by<L, F>( self, other: L, partial_cmp: F, ) -> Result<Option<Ordering>, Self::Error>

where Self: Sized, L: IntoFallibleLender<Error = Self::Error>, F: for<'all> FnMut(FallibleLend<'all, Self>, FallibleLend<'all, L::FallibleLender>) -> Result<Option<Ordering>, Self::Error>,

Documentation is incomplete. Refer to Iterator::partial_cmp_by for more information

fn eq<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialEq<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::eq for more information

fn eq_by<L, F>(self, other: L, eq: F) -> Result<bool, Self::Error>

where Self: Sized, L: IntoFallibleLender<Error = Self::Error>, F: for<'all> FnMut(FallibleLend<'all, Self>, FallibleLend<'all, L::FallibleLender>) -> Result<bool, Self::Error>,

Documentation is incomplete. Refer to Iterator::eq_by for more information

fn ne<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialEq<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::ne for more information

fn lt<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialOrd<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::lt for more information

fn le<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialOrd<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::le for more information

fn gt<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialOrd<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::gt for more information

fn ge<L>(self, other: L) -> Result<bool, Self::Error>

where L: IntoFallibleLender<Error = Self::Error>, for<'all> FallibleLend<'all, Self>: PartialOrd<FallibleLend<'all, L::FallibleLender>>, Self: Sized,

Documentation is incomplete. Refer to Iterator::ge for more information

fn is_sorted<T>(self) -> Result<bool, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, T: PartialOrd,

Documentation is incomplete. Refer to Iterator::is_sorted for more information

fn is_sorted_by<T, F>(self, compare: F) -> Result<bool, Self::Error>

where Self: Sized, for<'all> FallibleLend<'all, Self>: ToOwned<Owned = T>, F: FnMut(&T, &T) -> Result<Option<Ordering>, Self::Error>,

Documentation is incomplete. Refer to Iterator::is_sorted_by for more information

fn is_sorted_by_key<F, K>(self, f: F) -> Result<bool, Self::Error>

where Self: Sized, F: FnMut(FallibleLend<'_, Self>) -> Result<K, Self::Error>, K: PartialOrd,

Documentation is incomplete. Refer to Iterator::is_sorted_by_key for more information

fn iter<'this>(self) -> Iter<'this, Self>

where Self: Sized + 'this, for<'all> FallibleLend<'all, Self>: 'this,

Turn this lender into a FallibleIterator where it has already fulfilled the requirements of the FallibleIterator trait.

impl<'lend, E, L> FallibleLending<'lend> for FallibleOnce<'_, E, L>

where L: ?Sized + for<'all> FallibleLending<'all>,

type Lend = <L as FallibleLending<'lend>>::Lend

The type being lent.

impl<'a, E, L> FusedFallibleLender for FallibleOnce<'a, E, L>

where E: 'a, L: ?Sized + for<'all> FallibleLending<'all>,