iter-index 1.0.0

More flexible alternative to Iterator's enumerate() method
Documentation

crate documentation license license

iter-index crate

This is a simple extension trait that provides a more flexible alternative to the iterator's method enumerate(). It allows to:

  • use a custom type for the index with index::<T>()
  • define a custom start value with index_start::<T>(start: T)
  • define a custom step value with index_step::<T>(start: T, step: T).

Examples

use iter_index::IndexerIterator;

let mut map = HashMap::<u8, &str>::new();
for (k, v) in vec!["a", "b", "c"].into_iter().index() {
    map.insert(k, v);
}
assert_eq!(map, HashMap::from([(0_u8, "a"), (1_u8, "b"), (2_u8, "c")]));
let items = vec!["a", "b", "c"];
let mut result = items.into_iter().index_start::<u8>(97);

assert_eq!(result.next(), Some((97_u8, "a")));
assert_eq!(result.next(), Some((98_u8, "b")));
assert_eq!(result.next(), Some((99_u8, "c")));
assert_eq!(result.next(), None);
let items = vec!["a", "b", "c"];
let mut result = items.into_iter().index_step::<u32>(100, 10);

assert_eq!(result.next(), Some((100_u32, "a")));
assert_eq!(result.next(), Some((110_u32, "b")));
assert_eq!(result.next(), Some((120_u32, "c")));
assert_eq!(result.next(), None);

License

This code is licensed under either MIT License or Apache License 2.0.