Struct spans::SpansBy

pub struct SpansBy<I: Iterator, K, F> { /* fields omitted */ }

SpansBy wraps an iterator and provides progressive access to contiguous spans of the iterator.

See Spans::spans_by_key for more information.

Implementations

impl<I, K, C, F> SpansBy<I, K, F> where
    I: Iterator,
    K: Fn(&I::Item) -> C,
    C: Copy,
    F: Fn(C, C) -> bool, 

pub fn next(&mut self) -> Option<Span<'_, I, K, C, F>>

Returns the next span or None if the iterator terminated.

Example

use spans::Spans;

let vec = vec![1, 2, 5];
let mut spans = vec.iter().spans_by_key(|&&x| x, |a, b| a + 1 == b);

while let Some(span) = spans.next() {
    // do something with `span`
    let count = span.count();
    assert!(count > 0); // true for all spans
    assert!(count < 3); // true for the spans in this example
}