#iterator #peek #peekable #iterator-adapter #lookahead #multipeek

no-std peekmore

Iterator adapter like Peekable, but for peeking forward multiple elements

17 releases (5 stable)

1.3.0 Jun 5, 2023
1.2.0 Mar 16, 2023
1.0.0 Dec 30, 2020
0.5.6 Aug 27, 2020
0.4.0 Sep 20, 2019

#30 in No standard library

Download history 746/week @ 2023-11-26 844/week @ 2023-12-03 841/week @ 2023-12-10 757/week @ 2023-12-17 310/week @ 2023-12-24 125/week @ 2023-12-31 182/week @ 2024-01-07 240/week @ 2024-01-14 424/week @ 2024-01-21 477/week @ 2024-01-28 394/week @ 2024-02-04 305/week @ 2024-02-11 406/week @ 2024-02-18 480/week @ 2024-02-25 280/week @ 2024-03-03 162/week @ 2024-03-10

1,364 downloads per month
Used in 23 crates (13 directly)

MIT/Apache

69KB
1K SLoC

peekmore

This crate introduces a multi-peekable iterator. The iterator is similar to core::iterator::Peekable. The main difference is that Peekable only allows you to peek at the next element and no further. This crate aims to take that limitation away.

The documentation and more extensive example usage can be found at docs.rs/peekmore.

Usage example:

use peekmore::PeekMore;

fn main() {
    let range10 = 0..11;
    let mut peekable = range10.peekmore();
    
    // Peek at the first element
    let peek_first = peekable.peek();
    assert_eq!(*peek_first.unwrap(), 0);
    
    let peek_first_redux = peekable.peek_nth(0);
    assert_eq!(*peek_first_redux.unwrap(), 0);
    
    // Peek at the 10th (index) element
    let peek_tenth = peekable.peek_nth(10);
    assert_eq!(*peek_tenth.unwrap(), 10);
    
    // Consume the 10th element
    let tenth = peekable.nth(10);
    assert_eq!(tenth.unwrap(), 10);
    
    // Show that there are no more elements
    assert_eq!(peekable.peek(), None);
    assert_eq!(peekable.next(), None);
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies