Trait bitstream_io::Primitive

pub trait Primitive {
    type Bytes: AsRef<[u8]> + AsMut<[u8]>;

    // Required methods
    fn buffer() -> Self::Bytes;
    fn to_be_bytes(self) -> Self::Bytes;
    fn to_le_bytes(self) -> Self::Bytes;
    fn from_be_bytes(bytes: Self::Bytes) -> Self;
    fn from_le_bytes(bytes: Self::Bytes) -> Self;
}

A trait intended for simple fixed-length primitives (such as ints and floats) which allows them to be read and written to streams of different endiannesses verbatim.

Required Associated Types

type Bytes: AsRef<[u8]> + AsMut<[u8]>

The raw byte representation of this numeric type

Required Methods

fn buffer() -> Self::Bytes

An empty buffer of this type’s size

fn to_be_bytes(self) -> Self::Bytes

Our value in big-endian bytes

fn to_le_bytes(self) -> Self::Bytes

Our value in little-endian bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

Convert big-endian bytes to our value

fn from_le_bytes(bytes: Self::Bytes) -> Self

Convert little-endian bytes to out value

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl Primitive for f32

type Bytes = [u8; 4]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for f64

type Bytes = [u8; 8]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for i8

type Bytes = [u8; 1]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for i16

type Bytes = [u8; 2]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for i32

type Bytes = [u8; 4]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for i64

type Bytes = [u8; 8]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for i128

type Bytes = [u8; 16]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for u8

type Bytes = [u8; 1]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for u16

type Bytes = [u8; 2]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for u32

type Bytes = [u8; 4]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for u64

type Bytes = [u8; 8]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl Primitive for u128

type Bytes = [u8; 16]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

impl<const N: usize> Primitive for [u8; N]

type Bytes = [u8; N]

fn buffer() -> Self::Bytes

fn to_be_bytes(self) -> Self::Bytes

fn to_le_bytes(self) -> Self::Bytes

fn from_be_bytes(bytes: Self::Bytes) -> Self

fn from_le_bytes(bytes: Self::Bytes) -> Self

Implementors