Rust Iterator.step_by用法及代码示例

用法

fn step_by(self, step: usize) -> StepBy<Self>

创建一个迭代器，从同一点开始，但在每次迭代时按给定的数量步进。

注 1：无论给出的步骤如何，迭代器的第一个元素将始终被返回。

注2：被忽略的元素被拉取的时间不固定。 StepBy 的行为类似于序列 self.next() 、 self.nth(step-1) 、 self.nth(step-1) 、...，但也可以自由地表现为序列 advance_n_and_return_first(&mut self, step) 、 advance_n_and_return_first(&mut self, step) 、... 对于某些迭代器来说，使用哪种方式可能会改变性能原因。第二种方式将更早地推进迭代器并且可能消耗更多的项目。

advance_n_and_return_first 相当于：

fn advance_n_and_return_first<I>(iter: &mut I, n: usize) -> Option<I::Item>
where
    I: Iterator,
{
    let next = iter.next();
    if n > 1 {
        iter.nth(n - 2);
    }
    next
}

Panics

如果给定的步骤是 0 ，该方法将Panics。

例子

基本用法：

let a = [0, 1, 2, 3, 4, 5];
let mut iter = a.iter().step_by(2);

assert_eq!(iter.next(), Some(&0));
assert_eq!(iter.next(), Some(&2));
assert_eq!(iter.next(), Some(&4));
assert_eq!(iter.next(), None);