peeking-iter 0.3.0

An iterator adapter that allows infinitely-deep peeking
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

//! A fast and simple iterator adapter that allows peeking with any depth:
//!
//! ```rust
//! use peeking_iter::peeking::*;
//!
//! fn main() {
//!     let mut it = PeekingIter::new(0..=2);
//!
//!     assert_eq!(it.next(), Some(0));
//!     assert_eq!(it.peek(), Some(1));
//!     assert_eq!(it.peek(), Some(2));
//!     assert_eq!(it.next(), Some(1));
//!     assert_eq!(it.peek(), Some(2));
//!     assert_eq!(it.peek(), None);
//! }
//! ```
//!
//! # Why?
//! - ~1.5x faster than itertools' `MultiPeek`
//! - Has useful methods initially designed with lexing and parsing in mind (see `Parser`)

pub mod parser;
pub mod peeking;