Rust core::iter::Iterator.peekable用法及代码示例

用法

fn peekable(self) -> Peekable<Self> where    Self:Sized,

创建一个迭代器，该迭代器可以使用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大神的英文原创作品 core::iter::Iterator.peekable。非经特殊声明，原始代码版权归原作者所有，本译文的传播和使用请遵循“署名-相同方式共享 4.0 国际 (CC BY-SA 4.0)”协议。