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);