std::ops::Deref

Trait std::ops::Deref

#[lang = "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

Required Methods

Implementors

• 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<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 ManuallyDrop<T>
• 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 Deref for CString
• impl Deref for OsString
• impl<T> Deref for AssertUnwindSafe<T>
• impl Deref for PathBuf
• impl<'mutex, T: ?Sized> Deref for MutexGuard<'mutex, T>
• impl<'rwlock, T: ?Sized> Deref for RwLockReadGuard<'rwlock, T>
• impl<'rwlock, T: ?Sized> Deref for RwLockWriteGuard<'rwlock, T>