Trait std::ops::Deref

pub trait Deref {
    type Target: ?Sized;
    fn deref(&self) -> &Self::Target;
}

The Deref trait is used to specify the functionality of dereferencing operations, like *v.

Deref also enables 'Deref coercions'.

Examples

A struct with a single field which is accessible via dereferencing the struct.

use std::ops::Deref;

struct DerefExample<T> {
    value: T
}

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

    fn deref(&self) -> &T {
        &self.value
    }
}

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

Associated Types

type Target: ?Sized

The resulting type after dereferencing

Required Methods

fn deref(&self) -> &Self::Target

The method called to dereference a value

Implementors

• impl<T> Deref for Box<T> where T: ?Sized
• impl<T> Deref for Arc<T> where T: ?Sized
• impl<T> Deref for Rc<T> where T: ?Sized
• impl<T> Deref for NonZero<T> where T: Zeroable
• impl<T> Deref for Unique<T> where T: ?Sized
• impl<T> Deref for Shared<T> where T: ?Sized
• impl<'a, T> Deref for &'a T where T: ?Sized
• impl<'a, T> Deref for &'a mut T where T: ?Sized
• impl<'b, T> Deref for Ref<'b, T> where T: ?Sized
• impl<'b, T> Deref for RefMut<'b, T> where T: ?Sized
• impl<'a, T> Deref for PeekMut<'a, T> where T: Ord
• impl<'a, B> Deref for Cow<'a, B> where B: ToOwned + ?Sized
• impl Deref for String
• impl<T> Deref for Vec<T>
• impl Deref for CString
• impl Deref for OsString
• impl Deref for PathBuf