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.

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 has_terminated(&self) -> bool

Returns true if the decoder cannot decode items anymore, otherwise false.

fn requiring_bytes(&self) -> ByteCount

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