Struct std::ptr::DynMetadata

source ·
pub struct DynMetadata<Dyn>where
    Dyn: ?Sized,{
    vtable_ptr: &'static VTable,
    phantom: PhantomData<Dyn>,
}
🔬This is a nightly-only experimental API. (ptr_metadata #81513)
Expand description

The metadata for a Dyn = dyn SomeTrait trait object type.

It is a pointer to a vtable (virtual call table) that represents all the necessary information to manipulate the concrete type stored inside a trait object. The vtable notably it contains:

  • type size
  • type alignment
  • a pointer to the type’s drop_in_place impl (may be a no-op for plain-old-data)
  • pointers to all the methods for the type’s implementation of the trait

Note that the first three are special because they’re necessary to allocate, drop, and deallocate any trait object.

It is possible to name this struct with a type parameter that is not a dyn trait object (for example DynMetadata<u64>) but not to obtain a meaningful value of that struct.

Fields§

§vtable_ptr: &'static VTable
🔬This is a nightly-only experimental API. (ptr_metadata #81513)
§phantom: PhantomData<Dyn>
🔬This is a nightly-only experimental API. (ptr_metadata #81513)

Implementations§

source§

impl<Dyn> DynMetadata<Dyn>where Dyn: ?Sized,

source

pub fn size_of(self) -> usize

🔬This is a nightly-only experimental API. (ptr_metadata #81513)

Returns the size of the type associated with this vtable.

source

pub fn align_of(self) -> usize

🔬This is a nightly-only experimental API. (ptr_metadata #81513)

Returns the alignment of the type associated with this vtable.

source

pub fn layout(self) -> Layout

🔬This is a nightly-only experimental API. (ptr_metadata #81513)

Returns the size and alignment together as a Layout

Trait Implementations§

source§

impl<Dyn> Clone for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn clone(&self) -> DynMetadata<Dyn>

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<Dyn> Debug for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
source§

impl<Dyn> Eq for DynMetadata<Dyn>where Dyn: ?Sized,

source§

impl<Dyn> Hash for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn hash<H>(&self, hasher: &mut H)where H: Hasher,

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<Dyn> Ord for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn cmp(&self, other: &DynMetadata<Dyn>) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · source§

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · source§

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval. Read more
source§

impl<Dyn> PartialEq<DynMetadata<Dyn>> for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn eq(&self, other: &DynMetadata<Dyn>) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<Dyn> PartialOrd<DynMetadata<Dyn>> for DynMetadata<Dyn>where Dyn: ?Sized,

source§

fn partial_cmp(&self, other: &DynMetadata<Dyn>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more
source§

impl<Dyn> Copy for DynMetadata<Dyn>where Dyn: ?Sized,

source§

impl<Dyn> Send for DynMetadata<Dyn>where Dyn: ?Sized,

source§

impl<Dyn> Sync for DynMetadata<Dyn>where Dyn: ?Sized,

source§

impl<Dyn> Unpin for DynMetadata<Dyn>where Dyn: ?Sized,

Auto Trait Implementations§

§

impl<Dyn> !RefUnwindSafe for DynMetadata<Dyn>

§

impl<Dyn> !UnwindSafe for DynMetadata<Dyn>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.