Rust VecDeque.drain用法及代碼示例

本文簡要介紹rust語言中 std::collections::VecDeque.drain 的用法。

用法

pub fn drain<R>(&mut self, range: R) -> Drain<'_, T, A> where    R: RangeBounds<usize>,

創建一個排水迭代器，該迭代器刪除 VecDeque 中的指定範圍並產生已刪除的項目。

注1：即使直到最後沒有消耗迭代器，元素範圍也會被刪除。

注 2：如果未刪除 Drain 值，但它所持有的借用過期(例如，由於 mem::forget )，則未指定從雙端隊列中刪除多少個元素。

Panics

如果起點大於終點或終點大於向量的長度，則會出現Panics。

例子

use std::collections::VecDeque;

let mut v: VecDeque<_> = vec![1, 2, 3].into_iter().collect();
let drained = v.drain(2..).collect::<VecDeque<_>>();
assert_eq!(drained, [3]);
assert_eq!(v, [1, 2]);

// A full range clears all contents
v.drain(..);
assert!(v.is_empty());

相關用法

注：本文由純淨天空篩選整理自rust-lang.org大神的英文原創作品 std::collections::VecDeque.drain。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。