Rust Iterator.peekable用法及代码示例

本文简要介绍rust语言中 std::iter::Iterator.peekable 的用法。

用法

fn peekable(self) -> Peekable<Self>

创建一个迭代器，该迭代器可以使用 peek 和 peek_mut 方法查看迭代器的下一个元素而不使用它。有关更多信息，请参阅他们的文档。

请注意，当第一次调用 peek 或 peek_mut 时，底层迭代器仍然是高级的：为了检索下一个元素，在底层迭代器上调用 next ，因此会产生任何副作用(即除了将发生 next 方法的下一个值。

例子

基本用法：

let xs = [1, 2, 3];

let mut iter = xs.iter().peekable();

// peek() lets us see into the future
assert_eq!(iter.peek(), Some(&&1));
assert_eq!(iter.next(), Some(&1));

assert_eq!(iter.next(), Some(&2));

// we can peek() multiple times, the iterator won't advance
assert_eq!(iter.peek(), Some(&&3));
assert_eq!(iter.peek(), Some(&&3));

assert_eq!(iter.next(), Some(&3));

// after the iterator is finished, so is peek()
assert_eq!(iter.peek(), None);
assert_eq!(iter.next(), None);

使用 peek_mut 在不推进迭代器的情况下改变下一项：

let xs = [1, 2, 3];

let mut iter = xs.iter().peekable();

// `peek_mut()` lets us see into the future
assert_eq!(iter.peek_mut(), Some(&mut &1));
assert_eq!(iter.peek_mut(), Some(&mut &1));
assert_eq!(iter.next(), Some(&1));

if let Some(mut p) = iter.peek_mut() {
    assert_eq!(*p, &2);
    // put a value into the iterator
    *p = &1000;
}

// The value reappears as the iterator continues
assert_eq!(iter.collect::<Vec<_>>(), vec![&1000, &3]);

相关用法

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