Struct safe_transmute::error::IncompatibleVecTargetError

pub struct IncompatibleVecTargetError<S, T> {
    pub vec: Vec<S>,
    // some fields omitted
}

Incompatible vector transmutation error.

Returned when the element type S does not allow a safe vector transmutation to the target element type T. This happens when either the size or minimum memory alignment requirements are not met:

• std::mem::align_of::<S>() != std::mem::align_of::<T>()
• std::mem::size_of::<S>() != std::mem::size_of::<T>()

Fields

vec: Vec<S>

The original vector.

Implementations

impl<S, T> IncompatibleVecTargetError<S, T>

pub fn new(vec: Vec<S>) -> Self

Create an error with the given vector.

pub unsafe fn copy_unchecked(&self) -> Vec<T>

Create a copy of the data, transmuted into a new vector. As the vector will be properly aligned for accessing values of type T, this operation will not fail due to memory alignment constraints.

Safety

The byte data in the vector needs to correspond to a valid contiguous sequence of T values.

pub fn copy(&self) -> Vec<T> where
    T: TriviallyTransmutable, 

Create a copy of the data, transmuted into a new vector. As T is trivially transmutable, and the new vector will be properly allocated for accessing values of type T, this operation is safe and will never fail.

Trait Implementations

impl<S: Clone, T: Clone> Clone for IncompatibleVecTargetError<S, T>

fn clone(&self) -> IncompatibleVecTargetError<S, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S, T> Debug for IncompatibleVecTargetError<S, T>

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

Formats the value using the given formatter.

impl<S, T> Display for IncompatibleVecTargetError<S, T>

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

Formats the value using the given formatter.

impl<S, T> Error for IncompatibleVecTargetError<S, T>

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl<'a, S, T> From<IncompatibleVecTargetError<S, T>> for Error<'a, S, T>

fn from(e: IncompatibleVecTargetError<S, T>) -> Self

Performs the conversion.

impl<S: Hash, T: Hash> Hash for IncompatibleVecTargetError<S, T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<S: PartialEq, T: PartialEq> PartialEq<IncompatibleVecTargetError<S, T>> for IncompatibleVecTargetError<S, T>

fn eq(&self, other: &IncompatibleVecTargetError<S, T>) -> bool

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

fn ne(&self, other: &IncompatibleVecTargetError<S, T>) -> bool

This method tests for !=.

impl<S: Eq, T: Eq> Eq for IncompatibleVecTargetError<S, T>

impl<S, T> StructuralEq for IncompatibleVecTargetError<S, T>

impl<S, T> StructuralPartialEq for IncompatibleVecTargetError<S, T>