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。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。