3 unstable releases

0.2.1 Jan 2, 2022
0.2.0 Jun 14, 2021
0.1.0 May 2, 2021

#2062 in Rust patterns

Download history 46/week @ 2024-03-24 92/week @ 2024-03-31 30/week @ 2024-04-07 33/week @ 2024-04-14 26/week @ 2024-04-21 23/week @ 2024-04-28 24/week @ 2024-05-05 32/week @ 2024-05-12 41/week @ 2024-05-19 24/week @ 2024-05-26 33/week @ 2024-06-02 27/week @ 2024-06-09 40/week @ 2024-06-16 46/week @ 2024-06-23 6/week @ 2024-06-30 29/week @ 2024-07-07

124 downloads per month
Used in 6 crates (4 directly)

MIT license

26KB
724 lines

iterator-ext: An extension to Rust's Iterator trait.

Usage

The crate provides the IteratorExt trait extends the capability of those types that implements Iterator. It provides try_filter(), try_flatten() and more fallible adaptors that are analogous to those of Iterator.

The example demonstrates the usage of the adaptors. It accumulates the values from 0 to 9, and keeps only even outcomes. It raises error when the accumulation exceeds 10.

use iterator_ext::IteratorExt;
//!
let results: Vec<_> = (0..10)
    .map(Ok)
    .try_scan(0, |acc, val| {
        *acc += val;
        if *acc <= 10 {
            Ok(Some(*acc))
        } else {
            Err("exceed limit")
        }
    })
    .try_filter(|val| Ok(val % 2 == 0))
    .collect();
//!
assert_eq!(results, vec![Ok(0), Ok(6), Ok(10), Err("exceed limit")]);

License

MIT license. See LICENSE.txt file.


lib.rs:

An extension to Iterator trait.

The IteratorExt trait extends the capability of those types that implements Iterator. It provides try_filter(), try_flatten() and more fallible adaptors that are analogous to those of Iterator.

The example demonstrates the usage of the adaptors. It accumulates the values from 0 to 9, and keeps only even outcomes. It raises error when the accumulation exceeds 10.

use iterator_ext::IteratorExt;

let results: Vec<_> = (0..10)
    .map(Ok)
    .try_scan(0, |acc, val| {
        *acc += val;
        if *acc <= 10 {
            Ok(Some(*acc))
        } else {
            Err("exceed limit")
        }
    })
    .try_filter(|val| Ok(val % 2 == 0))
    .collect();

assert_eq!(results, vec![Ok(0), Ok(6), Ok(10), Err("exceed limit")]);

No runtime deps