Struct bitflags::__core::iter::Map
[−]
[src]
#[must_use = "iterator adaptors are lazy and do nothing unless consumed"]
pub struct Map<I, F> {
// some fields omitted
}1.0.0An iterator that maps the values of iter with f.
This struct is created by the map() method on Iterator. See its
documentation for more.
Notes about side effects
The map() iterator implements DoubleEndedIterator, meaning that
you can also map() backwards:
let v: Vec<i32> = vec![1, 2, 3].into_iter().rev().map(|x| x + 1).collect(); assert_eq!(v, [4, 3, 2]);
But if your closure has state, iterating backwards may act in a way you do not expect. Let's go through an example. First, in the forward direction:
let mut c = 0; for pair in vec!['a', 'b', 'c'].into_iter() .map(|letter| { c += 1; (letter, c) }) { println!("{:?}", pair); }
This will print "('a', 1), ('b', 2), ('c', 3)".
Now consider this twist where we add a call to rev. This version will
print ('c', 1), ('b', 2), ('a', 3). Note that the letters are reversed,
but the values of the counter still go in order. This is because map() is
still being called lazilly on each item, but we are popping items off the
back of the vector now, instead of shifting them from the front.
let mut c = 0; for pair in vec!['a', 'b', 'c'].into_iter() .map(|letter| { c += 1; (letter, c) }) .rev() { println!("{:?}", pair); }