Struct Aligned

Source
pub struct Aligned<T, ToSizeOfType>
where T: Parcel, ToSizeOfType: Sized,
{ pub value: T, /* private fields */ }
Expand description

A value that is aligned to a specified number of bytes.

When bytes are written, they are zero-padding at the end until the total size is the smallest multiple of the size of ToSizeOfType.

When an Aligned type is read, a value of the inner T is first read, and then the minimum number of zero bytes in order to maintain alignment are read and ignored.

Type parameters:

  • T - The Parcel type that is to be transmitted
  • ToSizeOfType The transmitted bytes will be aligned to a multiple of size_of::<ToSizeOfType>(). For example, if ToSizeOfType = u32, then the written bytes will be aligned to a multiple of 4 bytes.

Examples:

extern crate protocol;
#[macro_use] extern crate protocol_derive;
use protocol::Parcel;

/// An example packet with a length prefix disjoint
/// from its data, with the data also
#[derive(Protocol, Clone, Debug, PartialEq)]
struct Packet {
    /// The length of the 'reason' string.
    pub reason_length: u8,
    /// The version number of the protocol.
    pub version_number: (u32, u32),
    #[protocol(length_prefix(bytes(reason_length)))]
    pub reason: protocol::logic::Aligned<String, u64>,

}

let raw_bytes = Packet {
    reason_length: 12,
    version_number: (11, 0xdeadbeef),
    reason: "hello world!".to_owned().into(),
}.raw_bytes(&protocol::Settings::default()).unwrap();

assert_eq!(&[
    12, // reason length
    0, 0, 0, 11, 0xde, 0xad, 0xbe, 0xef, // version number
    // the string "hello world".
    b'h', b'e', b'l', b'l', b'o', b' ', b'w', b'o', b'r', b'l', b'd', b'!',
    0x00, 0x00, 0x00, 0x00, // padding bytes to align to string to 16 bytes.
    ], &raw_bytes[..]);

Fields§

§value: T

The inner value.

Implementations§

Source§

impl<T, ToSizeOfType> Aligned<T, ToSizeOfType>
where T: Parcel, ToSizeOfType: Sized,

Source

pub fn new(value: T) -> Self

Creates a new aligned value.

Source

pub fn align_to_bytes() -> usize

Gets the number of bytes of the alignment.

Trait Implementations§

Source§

impl<T, ToSizeOfType> Clone for Aligned<T, ToSizeOfType>
where T: Parcel + Clone, ToSizeOfType: Sized + Clone,

Source§

fn clone(&self) -> Aligned<T, ToSizeOfType>

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<T, ToSizeOfType> Debug for Aligned<T, ToSizeOfType>
where T: Parcel + Debug, ToSizeOfType: Sized + Debug,

Source§

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

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

impl<T, ToSizeOfType> From<T> for Aligned<T, ToSizeOfType>
where T: Parcel, ToSizeOfType: Sized,

Source§

fn from(value: T) -> Self

Converts to this type from the input type.
Source§

impl<T, ToSizeOfType> Hash for Aligned<T, ToSizeOfType>
where T: Parcel + Hash, ToSizeOfType: Sized + Hash,

Source§

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

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<T, ToSizeOfType> Ord for Aligned<T, ToSizeOfType>
where T: Parcel + Ord, ToSizeOfType: Sized + Ord,

Source§

fn cmp(&self, other: &Aligned<T, ToSizeOfType>) -> Ordering

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

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

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

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

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

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

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

impl<T, ToSizeOfType> Parcel for Aligned<T, ToSizeOfType>
where T: Parcel, ToSizeOfType: Sized,

Source§

const TYPE_NAME: &'static str = "Aligned"

The textual name of the type.
Source§

fn read_field( read: &mut dyn Read, settings: &Settings, hints: &mut Hints, ) -> Result<Self, Error>

Reads a value from a stream. Read more
Source§

fn write_field( &self, write: &mut dyn Write, settings: &Settings, hints: &mut Hints, ) -> Result<(), Error>

Writes a value to a stream.
Source§

fn read(read: &mut dyn Read, settings: &Settings) -> Result<Self, Error>

Reads a new item with a fresh set of hints. Read more
Source§

fn write(&self, write: &mut dyn Write, settings: &Settings) -> Result<(), Error>

Writes a value to a stream.
Source§

fn into_stream(self, settings: &Settings) -> Result<Cursor<Vec<u8>>, Error>

Convers the value into a byte stream that implements std::io::Read.
Source§

fn from_raw_bytes(bytes: &[u8], settings: &Settings) -> Result<Self, Error>

Parses a new value from its raw byte representation. Read more
Source§

fn field_from_raw_bytes( bytes: &[u8], settings: &Settings, hints: &mut Hints, ) -> Result<Self, Error>

Parses a new value from its raw byte representation. Read more
Source§

fn raw_bytes(&self, settings: &Settings) -> Result<Vec<u8>, Error>

Gets the raw byte representation of the value.
Source§

fn raw_bytes_field( &self, settings: &Settings, hints: &mut Hints, ) -> Result<Vec<u8>, Error>

Gets the raw bytes of this type as a field of a larger type.
Source§

fn type_name(&self) -> &'static str

Gets the name of the type; Parcel::TYPE_NAME.
Source§

impl<T, ToSizeOfType> PartialEq for Aligned<T, ToSizeOfType>
where T: Parcel + PartialEq, ToSizeOfType: Sized + PartialEq,

Source§

fn eq(&self, other: &Aligned<T, ToSizeOfType>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<T, ToSizeOfType> PartialOrd for Aligned<T, ToSizeOfType>
where T: Parcel + PartialOrd, ToSizeOfType: Sized + PartialOrd,

Source§

fn partial_cmp(&self, other: &Aligned<T, ToSizeOfType>) -> 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

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

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

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

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

impl<T, ToSizeOfType> Copy for Aligned<T, ToSizeOfType>
where T: Parcel + Copy, ToSizeOfType: Sized + Copy,

Source§

impl<T, ToSizeOfType> Eq for Aligned<T, ToSizeOfType>
where T: Parcel + Eq, ToSizeOfType: Sized + Eq,

Source§

impl<T, ToSizeOfType> StructuralPartialEq for Aligned<T, ToSizeOfType>
where T: Parcel, ToSizeOfType: Sized,

Auto Trait Implementations§

§

impl<T, ToSizeOfType> Freeze for Aligned<T, ToSizeOfType>
where T: Freeze,

§

impl<T, ToSizeOfType> RefUnwindSafe for Aligned<T, ToSizeOfType>
where T: RefUnwindSafe, ToSizeOfType: RefUnwindSafe,

§

impl<T, ToSizeOfType> Send for Aligned<T, ToSizeOfType>
where T: Send, ToSizeOfType: Send,

§

impl<T, ToSizeOfType> Sync for Aligned<T, ToSizeOfType>
where T: Sync, ToSizeOfType: Sync,

§

impl<T, ToSizeOfType> Unpin for Aligned<T, ToSizeOfType>
where T: Unpin, ToSizeOfType: Unpin,

§

impl<T, ToSizeOfType> UnwindSafe for Aligned<T, ToSizeOfType>
where T: UnwindSafe, ToSizeOfType: UnwindSafe,

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

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

Source§

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

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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 T
where 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 T
where T: Clone,

Source§

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 T
where U: Into<T>,

Source§

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 T
where U: TryFrom<T>,

Source§

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.