Function core::mem::replace

#[must_use = "if you don't need the old value, you can just assign the new value directly"]
pub fn replace<T>(dest: &mut T, src: T) -> T

将 src 移至引用的 dest，返回先前的 dest 值。

这两个值都不会被丢弃。

• 如果要替换两个变量的值，请参见 swap。
• 如果要替换为默认值，请参见 take。

Examples

一个简单的例子:

use std::mem;

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

let old_v = mem::replace(&mut v, vec![3, 4, 5]);
assert_eq!(vec![1, 2], old_v);
assert_eq!(vec![3, 4, 5], v);

replace 允许通过用另一个值替换结构体字段来使用它。 没有 replace，您可能会遇到以下问题:

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

impl<T> Buffer<T> {
    fn replace_index(&mut self, i: usize, v: T) -> T {
        // 错误: 无法移出 & mut-pointer 指针的解引用
        let t = self.buf[i];
        self.buf[i] = v;
        t
    }
}

请注意，T 不一定实现 Clone，因此我们甚至无法克隆 self.buf[i] 以避免此举。 但是 replace 可以用于取消该索引处的原始值与 self 的关联，从而可以将其返回:

use std::mem;

impl<T> Buffer<T> {
    fn replace_index(&mut self, i: usize, v: T) -> T {
        mem::replace(&mut self.buf[i], v)
    }
}

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

assert_eq!(buffer.replace_index(0, 2), 0);
assert_eq!(buffer.buf[0], 2);