Struct Unaligned 

pub struct Unaligned<Data>(/* private fields */)
where
    Data: TrivialType;

Wrapper type for Data that is the same size, but doesn’t need to be aligned/has alignment of one byte.

This is similar to #[repr(packed)], but makes sure to only expose safe API when dealing with the contents. For example, if Data is unaligned and has fields, it is not sounds having references to its fields. This data structure prevents such invalid invariants.

Implementations

impl<Data> Unaligned<Data>

where Data: TrivialType,

pub const fn new(inner: Data) -> Self

Create a new instance

pub const fn as_inner(&self) -> Data

Get inner value

pub const fn replace(&mut self, value: Data)

Replace inner value

Trait Implementations

impl<Data> AnyBitPatternMarker for Unaligned<Data>

where Data: TrivialType + AnyBitPatternMarker,

impl<Data> Clone for Unaligned<Data>

where Data: TrivialType + Clone + Copy,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Data> Copy for Unaligned<Data>

where Data: TrivialType + Copy,

impl<Data> Debug for Unaligned<Data>

where Data: TrivialType + Debug + Copy,

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

Formats the value using the given formatter.

impl<Data> Decode for Unaligned<Data>

where Data: TrivialType + Decode,

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<Data> Default for Unaligned<Data>

where Data: TrivialType + Default,

fn default() -> Self

Returns the “default value” for a type.

impl<'de, Data> Deserialize<'de> for Unaligned<Data>

where Data: TrivialType + Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Data> Display for Unaligned<Data>

where Data: TrivialType + Display,

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

Formats the value using the given formatter.

impl<Data> Encode for Unaligned<Data>

where Data: TrivialType + Encode,

Available on crate feature scale-codec only.

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<T>(&self, dest: &mut T)

where T: Output + ?Sized,

Convert self to a slice and append it to the destination.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<Data> EncodeLike for Unaligned<Data>

where Data: TrivialType + Encode,

Available on crate feature scale-codec only.

impl<Data> Eq for Unaligned<Data>

where Data: TrivialType + Eq + Copy,

impl<Data> From<Data> for Unaligned<Data>

where Data: TrivialType,

fn from(value: Data) -> Self

Converts to this type from the input type.

impl<Data> Hash for Unaligned<Data>

where Data: TrivialType + Hash + Copy,

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<Data> MaxEncodedLen for Unaligned<Data>

where Data: TrivialType + MaxEncodedLen,

fn max_encoded_len() -> usize

Upper bound, in bytes, of the maximum encoded size of this item.

impl<Data> Ord for Unaligned<Data>

where Data: TrivialType + Ord + Copy,

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl<Data> PartialEq for Unaligned<Data>

where Data: TrivialType + PartialEq + Copy,

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<Data> PartialOrd for Unaligned<Data>

where Data: TrivialType + PartialOrd + Copy,

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<Data> Serialize for Unaligned<Data>

where Data: TrivialType + Serialize,

Available on crate feature serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<Data> StructuralPartialEq for Unaligned<Data>

where Data: TrivialType + PartialEq,

impl<Data> TrivialType for Unaligned<Data>

where Data: TrivialType,

const ALIGNMENT: Alignment = u8::ALIGNMENT

Alignment of the type in metadata.

const METADATA: &[u8]

Data structure metadata in binary form, describing shape and types of the contents, see IoTypeMetadataKind for encoding details.

const SIZE: u32

final fn try_from_bytes(bytes: &[u8]) -> Option<(&Self, &[u8])>

Parse the beginning of aligned bytes, returns the value and the remaining bytes.

final fn try_from_bytes_exact(bytes: &[u8]) -> Option<&Self>

Like Self::try_from_bytes(), but returns None if there are more bytes than the value

final fn try_from_bytes_mut(bytes: &mut [u8]) -> Option<(&mut Self, &mut [u8])>

Like Self::try_from_bytes(), but returns an exclusive reference.

final fn try_from_bytes_mut_exact(bytes: &mut [u8]) -> Option<&mut Self>

Like Self::try_from_bytes_mut(), but returns None if there are more bytes than the value

final fn from_bytes(bytes: &[u8]) -> Option<(&Self, &[u8])>

where Self: AnyBitPattern,

Create a reference to a value at the beginning of aligned bytes, returns the value and the remaining bytes.

final fn from_bytes_exact(bytes: &[u8]) -> Option<&Self>

where Self: AnyBitPattern,

Like Self::from_bytes(), but returns None if there are more bytes than the value

final unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

Similar to Self::from_bytes(), but for any type and without any checks

final fn from_bytes_mut(bytes: &mut [u8]) -> Option<(&mut Self, &mut [u8])>

where Self: AnyBitPattern,

Like Self::from_bytes(), but returns an exclusive reference

final fn from_bytes_mut_exact(bytes: &mut [u8]) -> Option<&mut Self>

where Self: AnyBitPattern,

Like Self::from_bytes_mut(), but returns None if there are more bytes than the value

final unsafe fn from_bytes_mut_unchecked(bytes: &mut [u8]) -> &mut Self

Similar to Self::from_bytes_mut(), but for any type and without any checks

final fn slice_from_bytes( bytes: &[u8], count: usize, ) -> Option<(&[Self], &[u8])>

where Self: AnyBitPattern,

Create a slice of count values at the beginning of aligned bytes, returns the values and the remaining bytes.

final fn slice_from_bytes_mut( bytes: &mut [u8], count: usize, ) -> Option<(&mut [Self], &mut [u8])>

where Self: AnyBitPattern,

Like Self::slice_from_bytes(), but returns an exclusive reference

final fn as_bytes(&self) -> &[u8; _]

Access the underlying byte representation of a data structure

final fn slice_as_bytes(values: &[Self]) -> &[u8]

Access the underlying byte representation of a slice of values

final fn as_bytes_mut(&mut self) -> &mut [u8; _]

where Self: AnyBitPattern,

Access the underlying mutable byte representation of a data structure

final unsafe fn as_bytes_mut_unchecked(&mut self) -> &mut [u8; _]

Similar to Self::as_bytes_mut(), but for any type.