Rust Iterator.advance_by用法及代码示例

用法

fn advance_by(&mut self, n: usize) -> Result<(), usize>

将迭代器前进n 元素。

此方法将通过调用 next 最多n 次来即刻地跳过n 元素，直到遇到 None 。

advance_by(n) 如果迭代器成功前进了n 个元素，则返回 Ok(()) ，如果遇到 None ，则返回 Err(k) ，其中k 是迭代器在用完元素之前前进的元素数(即迭代器的长度)。请注意， k 始终小于 n 。

调用 advance_by(0) 可以做有意义的工作，例如 Flatten 可以推进其外部迭代器，直到找到不为空的内部迭代器，这通常允许它返回比初始状态更准确的 size_hint()。 advance_by(0) 可能返回 Ok() 或 Err(0) 。前者不传达迭代器是否已耗尽的信息，后者可以被视为 next 已返回 None 。将 Err(0) 替换为 Ok 仅适用于 n = 0 。

例子

基本用法：

#![feature(iter_advance_by)]

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

assert_eq!(iter.advance_by(2), Ok(()));
assert_eq!(iter.next(), Some(&3));
assert_eq!(iter.advance_by(0), Ok(()));
assert_eq!(iter.advance_by(100), Err(1)); // only `&4` was skipped