Struct itertools::structs::GroupBy

#[must_use = "iterator adaptors are lazy and do nothing unless consumed"]
pub struct GroupBy<K, I, F> where
    I: Iterator,  { /* fields omitted */ }

GroupBy is the storage for the lazy grouping operation.

If the groups are consumed in their original order, or if each group is dropped without keeping it around, then GroupBy uses no allocations. It needs allocations only if several group iterators are alive at the same time.

This type implements IntoIterator (it is not an iterator itself), because the group iterators need to borrow from this value. It should be stored in a local variable or temporary and iterated.

See .group_by() for more information.

Trait Implementations

impl<'a, K, I, F> IntoIterator for &'a GroupBy<K, I, F> where     I: Iterator,     I::Item: 'a,     F: FnMut(&I::Item) -> K,     K: PartialEq,

type Item = (K, Group<'a, K, I, F>)

The type of the elements being iterated over.

type IntoIter = Groups<'a, K, I, F>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.