Function core::mem::take

pub fn take<T: Default>(dest: &mut T) -> T

用默认值 T 替换 dest，并返回以前的 dest 值。

• 如果要替换两个变量的值，请参见 swap。
• 如果要替换为传递的值而不是默认值，请参见 replace。

Examples

一个简单的例子：

use std::mem;

let mut v: Vec<i32> = vec![1, 2];

let old_v = mem::take(&mut v);
assert_eq!(vec![1, 2], old_v);
assert!(v.is_empty());

take 允许通过将结构体字段替换为 “empty” 值来获取结构体字段的所有权。 没有 take，您可能会遇到以下问题：

struct Buffer<T> { buf: Vec<T> }

impl<T> Buffer<T> {
    fn get_and_reset(&mut self) -> Vec<T> {
        // 错误：无法移出 `&mut` 指针的解引用
        let buf = self.buf;
        self.buf = Vec::new();
        buf
    }
}

请注意，T 不一定实现 Clone，因此它甚至无法克隆和重置 self.buf。 但是 take 可以用于取消 self.buf 的原始值与 self 的关联，从而可以将其返回：

use std::mem;

impl<T> Buffer<T> {
    fn get_and_reset(&mut self) -> Vec<T> {
        mem::take(&mut self.buf)
    }
}

let mut buffer = Buffer { buf: vec![0, 1] };
assert_eq!(buffer.buf.len(), 2);

assert_eq!(buffer.get_and_reset(), vec![0, 1]);
assert_eq!(buffer.buf.len(), 0);