Struct UnalignedI64 

pub struct UnalignedI64(/* private fields */);

A i64 that has an alignment requirement of 1 byte, i.e. is unaligned

This is useful in packed structures and slices of data contained in variable-length arrays in VPP messages.

Layout

UnalignedI64 is guaranteed to have the same layout and bit validity as i64.

They are also guaranteed to have the same size.

Implementations

impl UnalignedI64

pub const fn new(value: i64) -> Self

Creates a i64 that has an alignment requirement of 1 byte, i.e. is unaligned.

pub const fn get(self) -> i64

Returns the contained value as a primitive type.

pub const fn swap_bytes(self) -> Self

Reverses the byte order of the integer.

Examples

let n = UnalignedI64::new(0x1234567890123456i64);
let m = n.swap_bytes();

assert_eq!(m, 0x5634129078563412);

pub const fn to_be(self) -> Self

Converts self to big endian from the target’s endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

Examples

let n = UnalignedI64::new(0x1Ai64);

if cfg!(target_endian = "big") {
    assert_eq!(n.to_be(), n)
} else {
    assert_eq!(n.to_be(), n.swap_bytes())
}

pub const fn from_be(x: Self) -> Self

Converts an integer from big endian to the target’s endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

Examples

let n = UnalignedI64::new(0x1Ai64);

if cfg!(target_endian = "big") {
    assert_eq!(UnalignedI64::from_be(n), n)
} else {
    assert_eq!(UnalignedI64::from_be(n), n.swap_bytes())
}

Trait Implementations

impl Add<i64> for UnalignedI64

type Output = i64

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> i64

Performs the + operation.

impl Add for UnalignedI64

type Output = UnalignedI64

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl Clone for UnalignedI64

fn clone(&self) -> UnalignedI64

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnalignedI64

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

Formats the value using the given formatter.

impl Display for UnalignedI64

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

Formats the value using the given formatter.

impl Div<i64> for UnalignedI64

type Output = i64

The resulting type after applying the / operator.

fn div(self, rhs: i64) -> i64

Performs the / operation.

impl Div for UnalignedI64

type Output = UnalignedI64

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self

Performs the / operation.

impl From<UnalignedI64> for i64

fn from(value: UnalignedI64) -> Self

Converts to this type from the input type.

impl From<i64> for UnalignedI64

fn from(value: i64) -> Self

Converts to this type from the input type.

impl FromStr for UnalignedI64

type Err = ParseIntError

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for UnalignedI64

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 Mul<i64> for UnalignedI64

type Output = i64

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> i64

Performs the * operation.

impl Mul for UnalignedI64

type Output = UnalignedI64

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl Ord for UnalignedI64

fn cmp(&self, other: &UnalignedI64) -> 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.

impl PartialEq<i64> for UnalignedI64

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq for UnalignedI64

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd<i64> for UnalignedI64

fn partial_cmp(&self, other: &i64) -> 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 PartialOrd for UnalignedI64

fn partial_cmp(&self, other: &UnalignedI64) -> 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 Sub<i64> for UnalignedI64

type Output = i64

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> i64

Performs the - operation.

impl Sub for UnalignedI64

type Output = UnalignedI64

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl Copy for UnalignedI64

impl Eq for UnalignedI64

impl StructuralPartialEq for UnalignedI64