Struct bytecodec::bytes::CopyableBytesDecoder

pub struct CopyableBytesDecoder<B> { /* fields omitted */ }

A variant of BytesDecoder for copyable bytes types.

Unlike BytesDecoder, this has no restriction on decoding count.

Examples

use bytecodec::{Decode, Eos};
use bytecodec::bytes::CopyableBytesDecoder;

let mut decoder = CopyableBytesDecoder::new([0; 3]);
let mut input = b"foobar";

// Decodes first item
assert_eq!(decoder.requiring_bytes().to_u64(), Some(3));
let (_, item) = decoder.decode(&input[0..3], Eos::new(false)).unwrap();
assert_eq!(item.as_ref(), Some(b"foo"));

// Decodes second item
assert_eq!(decoder.requiring_bytes().to_u64(), Some(3));
let (_, item) = decoder.decode(&input[3..5], Eos::new(false)).unwrap();
assert_eq!(item, None);
assert_eq!(decoder.requiring_bytes().to_u64(), Some(1));

let (_, item) = decoder.decode(&input[5..], Eos::new(true)).unwrap();
assert_eq!(item.as_ref(), Some(b"bar"));

Methods

impl<B> CopyableBytesDecoder<B>

pub fn new(bytes: B) -> Self

Makes a new CopyableBytesDecoder instance.

Important traits for &'a mut W

impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn inner_ref(&self) -> &B

Returns a reference to the inner bytes.

Important traits for &'a mut W

impl<'a, W> Write for &'a mut W where
    W: Write + ?Sized, impl<'a, R> Read for &'a mut R where
    R: Read + ?Sized, impl<'a, I> Iterator for &'a mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;

pub fn inner_mut(&mut self) -> &mut B

Returns a mutable reference to the inner bytes.

pub fn into_inner(self) -> B

Takes ownership of this instance and returns the inner bytes.

Trait Implementations

impl<B: Debug> Debug for CopyableBytesDecoder<B>

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<B: Default> Default for CopyableBytesDecoder<B>

fn default() -> CopyableBytesDecoder<B>

Returns the "default value" for a type.

impl<B: AsRef<[u8]> + AsMut<[u8]> + Copy> Decode for CopyableBytesDecoder<B>

type Item = B

The type of items to be decoded.

fn decode(
    &mut self,
    buf: &[u8],
    eos: Eos
) -> Result<(usize, Option<Self::Item>)>

Consumes the given buffer (a part of a byte sequence), and decodes an item from it.

fn requiring_bytes(&self) -> ByteCount

Returns the lower bound of the number of bytes needed to decode the next item.