#iterator #nth #iterator-adapter #peek #cache #data-structures

peek-nth

An iterator adapter that allows you to efficiently peek the nth item of an iterator

2 unstable releases

Uses old Rust 2015

0.2.0 Apr 16, 2018
0.1.0 Apr 8, 2018

#12 in #nth

Download history 27/week @ 2024-03-13 29/week @ 2024-03-20 40/week @ 2024-03-27 46/week @ 2024-04-03 21/week @ 2024-04-10 30/week @ 2024-04-17 30/week @ 2024-04-24 18/week @ 2024-05-01 18/week @ 2024-05-08 22/week @ 2024-05-15 25/week @ 2024-05-22 21/week @ 2024-05-29 15/week @ 2024-06-05 19/week @ 2024-06-12 21/week @ 2024-06-19 12/week @ 2024-06-26

70 downloads per month
Used in 3 crates (via lexer)

MIT/Apache

9KB
81 lines

peek-nth

CircleCI branch AppVeyor branch Crates.io

An iterator adapter that allows you to efficiently peek the nth item of an iterator.

Itermediate values are memoized and heap allocations are avoided when possible.

Installation

First, add peek-nth to the dependencies section of your Cargo.toml:

[dependencies]
peek-nth = "0.2"

Next, add the following snippet to the entry point of your crate (lib.rs or main.rs):

extern crate peek_nth;

Usage

extern crate peek_nth;

use peek_nth::IteratorExt;

fn main() {
    let mut iter = "Hello, world!".chars().peekable_nth();

    assert_eq!(iter.peek_nth(4), Some(&'o')); // Cache Miss
    assert_eq!(iter.peek_nth(3), Some(&'l')); // Cache Hit
    assert_eq!(iter.peek_nth(2), Some(&'l')); // Cache Hit
    assert_eq!(iter.peek_nth(1), Some(&'e')); // Cache Hit
    assert_eq!(iter.peek_nth(0), Some(&'H')); // Cache Hit
    assert_eq!(iter.peek_nth(7), Some(&'w')); // Cache Miss

    assert_eq!(iter.collect::<String>(), "Hello, world!");
}

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

~125KB