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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。