Trait binout::Serializer

pub trait Serializer<T: Copy>: Copy {
    const CONST_SIZE: Option<usize> = None;

    // Required methods
    fn size(val: T) -> usize;
    fn write<W: Write + ?Sized>(output: &mut W, val: T) -> Result<()>;
    fn read<R: Read + ?Sized>(input: &mut R) -> Result<T>;

    // Provided methods
    fn write_all_values<W, InIter>(output: &mut W, values: InIter) -> Result<()>
       where W: Write + ?Sized,
             InIter: IntoIterator<Item = T> { ... }
    fn write_all<'a, W, InIter>(output: &mut W, values: InIter) -> Result<()>
       where W: Write + ?Sized,
             InIter: IntoIterator<Item = &'a T>,
             T: 'a { ... }
    fn array_content_size(array: &[T]) -> usize { ... }
    fn array_size(array: &[T]) -> usize { ... }
    fn write_array<W: Write + ?Sized>(output: &mut W, array: &[T]) -> Result<()> { ... }
    fn read_n<R: Read + ?Sized>(input: &mut R, n: usize) -> Result<Box<[T]>> { ... }
    fn read_array<R: Read + ?Sized>(input: &mut R) -> Result<Box<[T]>> { ... }
}

Trait implemented by each serializer for the following types: u8, u16, u32, u64, usize (which, for portability, is always serialized the same as u64).

Provided Associated Constants

const CONST_SIZE: Option<usize> = None

Either size of each value in bytes (if each value occupies constant size) or None.

Required Methods

fn size(val: T) -> usize

Returns number of bytes which write needs to serialize val.

fn write<W: Write + ?Sized>(output: &mut W, val: T) -> Result<()>

Serialize val to the given output.

fn read<R: Read + ?Sized>(input: &mut R) -> Result<T>

Deserialize value from the given input.

Provided Methods

fn write_all_values<W, InIter>(output: &mut W, values: InIter) -> Result<()>

where W: Write + ?Sized, InIter: IntoIterator<Item = T>,

Serialize all values into the given output.

fn write_all<'a, W, InIter>(output: &mut W, values: InIter) -> Result<()>

where W: Write + ?Sized, InIter: IntoIterator<Item = &'a T>, T: 'a,

Serialize all values into the given output.

fn array_content_size(array: &[T]) -> usize

Returns number of bytes occupied by serialized content of the array.

fn array_size(array: &[T]) -> usize

Returns number of bytes which write_array needs to serialize array.

fn write_array<W: Write + ?Sized>(output: &mut W, array: &[T]) -> Result<()>

Serialize array to the given input. Size of the array is serialized in VByte format.

fn read_n<R: Read + ?Sized>(input: &mut R, n: usize) -> Result<Box<[T]>>

Deserialize n values from the given input.

fn read_array<R: Read + ?Sized>(input: &mut R) -> Result<Box<[T]>>

Deserialize array from the given input. Size of the array is serialized in VByte format.

Object Safety

This trait is not object safe.

Implementors

impl Serializer<u8> for AsIs

const CONST_SIZE: Option<usize> = _

impl Serializer<u8> for VByte

const CONST_SIZE: Option<usize> = _

impl Serializer<u16> for AsIs

const CONST_SIZE: Option<usize> = _

impl Serializer<u16> for VByte

impl Serializer<u32> for AsIs

const CONST_SIZE: Option<usize> = _

impl Serializer<u32> for VByte

impl Serializer<u64> for AsIs

const CONST_SIZE: Option<usize> = _

impl Serializer<u64> for VByte

impl<S> Serializer<usize> for S

where S: Serializer<u64>,

const CONST_SIZE: Option<usize> = S::CONST_SIZE