Trait Cast

pub trait Cast:
    AlignOf
    + AllBitPatternsValid
    + 'static
    + PartialEq
    + Debug
    + ToOwned {
    // Required methods
    fn default_ref() -> &'static Self;
    fn try_from_aligned_slice(
        slice: &AlignedSlice<Self::AlignOf>,
    ) -> Result<&Self, WrongSize>;
    fn try_from_aligned_slice_mut(
        slice: &mut AlignedSlice<Self::AlignOf>,
    ) -> Result<&mut Self, WrongSize>;

    // Provided method
    fn from_aligned_slice(slice: &AlignedSlice<Self::AlignOf>) -> &Self { ... }
}

Trait implemented by all our types that have the same representation as the GVariant type

This allows casting appropriately aligned AlignedSlices to rust types.

Don’t implement this class for your own types. It’s already implemented for all appropriate types. It’s automatically implemented for Structure types generated by the gv! macro.

Required Methods

fn default_ref() -> &'static Self

Get a static reference to the default value for this type.

In GVariant every type has a default value which is used in certian circumstances in-lieu of returning errors during deserialisation. We’re always dealing with references so std::default::Default isn’t appropriate.

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

Provided Methods

fn from_aligned_slice(slice: &AlignedSlice<Self::AlignOf>) -> &Self

Cast slice to type Self.

This always succeeds. If the slice is the wrong size a defualt value is returned in accordance with the GVariant spec.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Cast for f64

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for i16

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for i32

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for i64

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for u8

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for u16

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for u32

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl Cast for u64

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( slice: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

impl<'a, T: Cast + 'static + Copy> Cast for [T]

fn default_ref() -> &'static Self

fn try_from_aligned_slice( slice: &AlignedSlice<Self::AlignOf>, ) -> Result<&Self, WrongSize>

fn try_from_aligned_slice_mut( _: &mut AlignedSlice<Self::AlignOf>, ) -> Result<&mut Self, WrongSize>

Implementors

impl Cast for Bool

impl Cast for Str

impl Cast for Variant

impl<T: Cast + ?Sized> Cast for MaybeNonFixedSize<T>

impl<T: Cast + ?Sized> Cast for NonFixedWidthArray<T>

impl<T: Cast> Cast for MaybeFixedSize<T>