This crate is deprecated.

Use Itertools::at_most_one instead, which provides equivalent functionality in a better fashion.

Single

This crate provides the Single trait for extracting the element from a single-element iterator.

License

You may use this crate under the MIT license or the Apache License 2.0 at your discretion.

Trait single::Single

pub trait Single: Iterator {
    fn single(self) -> Result<Self::Item, Error>;
}

Required Methods

fn single(self) -> Result<Self::Item, Error>

Get the single element from a single-element iterator.

Examples

assert_eq!(iter::empty::<i32>().single(), Err(single::Error::NoElements));
assert_eq!(iter::once(0).single(), Ok(0));
assert_eq!(iter::repeat(0).single(), Err(single::Error::MultipleElements));

Implementors

impl<I: Iterator> Single for I {}