Trait core::ops::Deref1.0.0[−][src]

pub trait Deref {
    type Target: ?Sized;
    #[must_use]
    fn deref(&self) -> &Self::Target;
}
Expand description

用于不可变解引用操作，例如 *v。

Deref 除了在不可变上下文中用于 (unary) * 运算符的显式解引用操作外，在许多情况下，编译器都隐式使用 Deref。 该机制称为 ‘Deref coercion’。 在可变上下文中，使用 DerefMut。

为智能指针实现 Deref 使得访问它们背后的数据变得方便，这就是为什么它们实现 Deref 的原因。 另一方面，有关 Deref 和 DerefMut 的规则是专门为容纳智能指针而设计的。 因此，Deref 只应为智能指针实现，以避免混淆。

出于类似的原因，此 trait 永远不会失败。当隐式调用 Deref 时，解引用过程中的失败可能会造成极大的混乱。

有关 Deref 强制的更多信息

如果 T 实现 Deref<Target = U>，并且 x 是 T 类型的值，则:

  • 在不可变的上下文中，*x (其中 T 既不是引用也不是裸指针) 等效于 * Deref::deref(&x)。
  • &T 类型的值被强制为 &U 类型的值
  • T 隐式实现 U 类型的所有 (不可变) 方法。

有关更多详细信息，请访问 Rust 编程语言中的章节 以及 解引用运算符，方法解析 和 type coercions 上的引用部分。

Examples

具有解引用的结构体可访问的具有单个字段的结构体。

use std::ops::Deref;

struct DerefExample<T> {
    value: T
}

impl<T> Deref for DerefExample<T> {
    type Target = T;

    fn deref(&self) -> &Self::Target {
        &self.value
    }
}

let x = DerefExample { value: 'a' };
assert_eq!('a', *x);
Run

Associated Types

解引用后的结果类型。

Required methods

解引用值。

Implementors