Trait plain::Plain[−][src]

pub unsafe trait Plain {
    fn from_bytes(bytes: &[u8]) -> Result<&Self, Error>
    where
        Self: Sized,
    { ... }

    fn slice_from_bytes(bytes: &[u8]) -> Result<&[Self], Error>
    where
        Self: Sized,
    { ... }

    fn slice_from_bytes_len(bytes: &[u8], len: usize) -> Result<&[Self], Error>
    where
        Self: Sized,
    { ... }

    fn from_mut_bytes(bytes: &mut [u8]) -> Result<&mut Self, Error>
    where
        Self: Sized,
    { ... }

    fn slice_from_mut_bytes(bytes: &mut [u8]) -> Result<&mut [Self], Error>
    where
        Self: Sized,
    { ... }

    fn slice_from_mut_bytes_len(
        bytes: &mut [u8], 
        len: usize
    ) -> Result<&mut [Self], Error>
    where
        Self: Sized,
    { ... }

    fn copy_from_bytes(&mut self, bytes: &[u8]) -> Result<(), Error> { ... }
}

A trait for plain data types that can be safely read from a byte slice.

A type can be Plain if it is #repr(C) and only contains data with no possible invalid values. Types that can’t be Plain include, but are not limited to, bool, char, enums, tuples, pointers and references.

At this moment, Drop types are also not legal, because compiler adds a special “drop flag” into the type. This is slated to change in the future.

On the other hand, arrays of a Plain type, and structures where all members are plain (and not Drop), are okay.

Structures that are not #repr(C), while not necessarily illegal in principle, are largely useless because they don’t have a stable layout. For example, the compiler is allowed to reorder fields arbitrarily.

All methods of this trait are implemented automatically as wrappers for crate-level funtions.

Provided methods

fn from_bytes(bytes: &[u8]) -> Result<&Self, Error> where
    Self: Sized, [src]

fn slice_from_bytes(bytes: &[u8]) -> Result<&[Self], Error> where
    Self: Sized, [src]

fn slice_from_bytes_len(bytes: &[u8], len: usize) -> Result<&[Self], Error> where
    Self: Sized, [src]

fn from_mut_bytes(bytes: &mut [u8]) -> Result<&mut Self, Error> where
    Self: Sized, [src]

fn slice_from_mut_bytes(bytes: &mut [u8]) -> Result<&mut [Self], Error> where
    Self: Sized, [src]

fn slice_from_mut_bytes_len(
    bytes: &mut [u8],
    len: usize
) -> Result<&mut [Self], Error> where
    Self: Sized, [src]

fn copy_from_bytes(&mut self, bytes: &[u8]) -> Result<(), Error>[src]

Loading content...

Implementors

impl Plain for i8[src]

impl Plain for i16[src]

impl Plain for i32[src]

impl Plain for i64[src]

impl Plain for isize[src]

impl Plain for u8[src]

impl Plain for u16[src]

impl Plain for u32[src]

impl Plain for u64[src]

impl Plain for usize[src]

impl<S> Plain for [S] where
    S: Plain, [src]

Loading content...