Trait 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 our value

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so 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