Trait packing::PackedBytes

pub trait PackedBytes<B>: PackedSize {
    type Error;
    fn to_bytes<En: Endian>(&self) -> Result<B, Self::Error>;
    fn from_bytes<En: Endian>(bytes: B) -> Result<Self, Self::Error>;
}

Trait that enables endian aware conversion to/from bytes for packable types

Mostly for primitives. Currently expected to accept/return arrays by proc macro. Benchmarking showed allocating a new 1 to 8 byte array during to/from bytes performed exactly the same as manual bit shifting or various other shenanigans.

TODO: Above perf statement likely only holds true up to a certain size. Currently nested structs and packing/unpacking them to/from &mut u8 is not supported.

Associated Types

type Error

Loading content...

Required methods

fn to_bytes<En: Endian>(&self) -> Result<B, Self::Error>

fn from_bytes<En: Endian>(bytes: B) -> Result<Self, Self::Error>

Loading content...

Implementors

impl PackedBytes<[u8; 1]> for bool

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 1], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 1]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 16]> for i128

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 16], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 16]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 16]> for u128

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 16], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 16]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 1]> for i8

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 1], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 1]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 1]> for u8

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 1], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 1]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 2]> for i16

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 2], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 2]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 2]> for u16

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 2], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 2]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 4]> for f32

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 4], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 4]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 4]> for i32

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 4], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 4]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 4]> for u32

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 4], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 4]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 8]> for f64

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 8], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 8]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 8]> for i64

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 8], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 8]) -> Result<Self, Self::Error>

impl PackedBytes<[u8; 8]> for u64

type Error = Infallible

fn to_bytes<En: Endian>(&self) -> Result<[u8; 8], Self::Error>

fn from_bytes<En: Endian>(bytes: [u8; 8]) -> Result<Self, Self::Error>

Loading content...