Rust DoubleEndedIterator.advance_back_by用法及代碼示例

用法

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

將迭代器從後麵推進n 元素。

advance_back_by 是 advance_by 的反向版本。此方法將通過調用 next_back 最多 n 次從後麵開始即刻地跳過 n 元素，直到遇到 None 。

advance_back_by(n) 如果迭代器成功前進了n 個元素，則返回 Ok(()) ，如果遇到 None ，則返回 Err(k) ，其中k 是迭代器在用完元素之前前進的元素數(即迭代器的長度)。請注意， k 始終小於 n 。

調用 advance_back_by(0) 可以做有意義的工作，例如 Flatten 可以推進其外部迭代器，直到找到不為空的內部迭代器，這通常允許它返回比初始狀態更準確的 size_hint()。 advance_back_by(0) 可能返回 Ok() 或 Err(0) 。前者不傳達迭代器是否已耗盡的信息，後者可以被視為 next_back 已返回 None 。將 Err(0) 替換為 Ok 僅適用於 n = 0 。

例子

基本用法：

#![feature(iter_advance_by)]

let a = [3, 4, 5, 6];
let mut iter = a.iter();

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