Function std::mem::take

1.40.0 · source ·
pub fn take<T>(dest: &mut T) -> Twhere
    T: Default,
Expand description

用默认值 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());
Run

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
    }
}
Run

请注意,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);
Run