当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust DoubleEndedIterator.advance_back_by用法及代码示例


本文简要介绍rust语言中 core::iter::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

相关用法


注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 core::iter::DoubleEndedIterator.advance_back_by。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。