本文简要介绍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 DoubleEndedIterator.try_rfold用法及代码示例
- Rust DoubleEndedIterator.rfold用法及代码示例
- Rust DoubleEndedIterator.rfind用法及代码示例
- Rust DoubleEndedIterator.nth_back用法及代码示例
- Rust DoubleEndedIterator.next_back用法及代码示例
- Rust DoubleEndedIterator用法及代码示例
- Rust DirBuilder.new用法及代码示例
- Rust DirEntry.metadata用法及代码示例
- Rust Duration.as_micros用法及代码示例
- Rust Duration.subsec_nanos用法及代码示例
- Rust DebugList.entries用法及代码示例
- Rust Duration.checked_add用法及代码示例
- Rust Div用法及代码示例
- Rust Drain.as_slice用法及代码示例
- Rust DirBuilder.recursive用法及代码示例
- Rust Duration.new用法及代码示例
- Rust DerefMut用法及代码示例
- Rust DirBuilder.create用法及代码示例
- Rust Drop用法及代码示例
- Rust DebugList用法及代码示例
- Rust DirEntry.path用法及代码示例
- Rust DebugMap.key用法及代码示例
- Rust Duration.subsec_micros用法及代码示例
- Rust DirEntry.file_type用法及代码示例
- Rust Duration.mul_f64用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 core::iter::DoubleEndedIterator.advance_back_by。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。