Struct Chain

pub struct Chain<T, U> { /* private fields */ }

A Chain sequences two buffers.

Chain is an adapter that links two underlying buffers and provides a continous view across both buffers. It is able to sequence either immutable buffers (Buf values) or mutable buffers (BufMut values).

This struct is generally created by calling Buf::chain. Please see that function’s documentation for more detail.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};
use embedrs_bytes::buf::Chain;

let buf = Bytes::from(&b"hello "[..]).into_buf()
            .chain(Bytes::from(&b"world"[..]));

let full: Bytes = buf.collect();
assert_eq!(full[..], b"hello world"[..]);

Implementations

impl<T, U> Chain<T, U>

pub fn new(a: T, b: U) -> Chain<T, U>

Creates a new Chain sequencing the provided values.

Examples

use embedrs_bytes::BytesMut;
use embedrs_bytes::buf::Chain;

let buf = Chain::new(
    BytesMut::with_capacity(1024),
    BytesMut::with_capacity(1024));

// Use the chained buffer

pub fn first_ref(&self) -> &T

Gets a reference to the first underlying Buf.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};

let buf = Bytes::from(&b"hello"[..]).into_buf()
            .chain(Bytes::from(&b"world"[..]));

assert_eq!(buf.first_ref().get_ref()[..], b"hello"[..]);

pub fn first_mut(&mut self) -> &mut T

Gets a mutable reference to the first underlying Buf.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};

let mut buf = Bytes::from(&b"hello "[..]).into_buf()
                .chain(Bytes::from(&b"world"[..]));

buf.first_mut().set_position(1);

let full: Bytes = buf.collect();
assert_eq!(full[..], b"ello world"[..]);

pub fn last_ref(&self) -> &U

Gets a reference to the last underlying Buf.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};

let buf = Bytes::from(&b"hello"[..]).into_buf()
            .chain(Bytes::from(&b"world"[..]));

assert_eq!(buf.last_ref().get_ref()[..], b"world"[..]);

pub fn last_mut(&mut self) -> &mut U

Gets a mutable reference to the last underlying Buf.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};

let mut buf = Bytes::from(&b"hello "[..]).into_buf()
                .chain(Bytes::from(&b"world"[..]));

buf.last_mut().set_position(1);

let full: Bytes = buf.collect();
assert_eq!(full[..], b"hello orld"[..]);

pub fn into_inner(self) -> (T, U)

Consumes this Chain, returning the underlying values.

Examples

use embedrs_bytes::{Bytes, Buf, IntoBuf};

let buf = Bytes::from(&b"hello"[..]).into_buf()
            .chain(Bytes::from(&b"world"[..]));

let (first, last) = buf.into_inner();
assert_eq!(first.get_ref()[..], b"hello"[..]);
assert_eq!(last.get_ref()[..], b"world"[..]);

Trait Implementations

impl<T, U> Buf for Chain<T, U>

where T: Buf, U: Buf,

fn remaining(&self) -> usize

Returns the number of bytes between the current position and the end of the buffer.

fn bytes(&self) -> &[u8]

Returns a slice starting at the current position and of length between 0 and Buf::remaining().

fn advance(&mut self, cnt: usize)

Advance the internal cursor of the Buf

fn has_remaining(&self) -> bool

Returns true if there are any more bytes to consume

fn copy_to_slice(&mut self, dst: &mut [u8])

Copies bytes from self into dst.

fn get_u8(&mut self) -> u8

Gets an unsigned 8 bit integer from self.

fn get_i8(&mut self) -> i8

Gets a signed 8 bit integer from self.

fn get_u16<T: ByteOrder>(&mut self) -> u16

Gets an unsigned 16 bit integer from self in the specified byte order.

fn get_i16<T: ByteOrder>(&mut self) -> i16

Gets a signed 16 bit integer from self in the specified byte order.

fn get_u32<T: ByteOrder>(&mut self) -> u32

Gets an unsigned 32 bit integer from self in the specified byte order.

fn get_i32<T: ByteOrder>(&mut self) -> i32

Gets a signed 32 bit integer from self in the specified byte order.

fn get_u64<T: ByteOrder>(&mut self) -> u64

Gets an unsigned 64 bit integer from self in the specified byte order.

fn get_i64<T: ByteOrder>(&mut self) -> i64

Gets a signed 64 bit integer from self in the specified byte order.

fn get_uint<T: ByteOrder>(&mut self, nbytes: usize) -> u64

Gets an unsigned n-byte integer from self in the specified byte order.

fn get_int<T: ByteOrder>(&mut self, nbytes: usize) -> i64

Gets a signed n-byte integer from self in the specified byte order.

fn get_f32<T: ByteOrder>(&mut self) -> f32

Gets an IEEE754 single-precision (4 bytes) floating point number from self in the specified byte order.

fn get_f64<T: ByteOrder>(&mut self) -> f64

Gets an IEEE754 double-precision (8 bytes) floating point number from self in the specified byte order.

fn take(self, limit: usize) -> Take<Self>

where Self: Sized,

Creates an adaptor which will read at most limit bytes from self.

fn chain<U>(self, next: U) -> Chain<Self, U::Buf>

where U: IntoBuf, Self: Sized,

Creates an adaptor which will chain this buffer with another.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adaptor for this instance of Buf.

fn reader(self) -> Reader<Self>

where Self: Sized,

Creates an adaptor which implements the Read trait for self.

fn iter(self) -> Iter<Self>

where Self: Sized,

Returns an iterator over the bytes contained by the buffer.

impl<T, U> BufMut for Chain<T, U>

where T: BufMut, U: BufMut,

fn remaining_mut(&self) -> usize

Returns the number of bytes that can be written from the current position until the end of the buffer is reached.

unsafe fn bytes_mut(&mut self) -> &mut [u8]

Returns a mutable slice starting at the current BufMut position and of length between 0 and BufMut::remaining_mut().

unsafe fn advance_mut(&mut self, cnt: usize)

Advance the internal cursor of the BufMut

fn has_remaining_mut(&self) -> bool

Returns true if there is space in self for more bytes.

fn put<T: IntoBuf>(&mut self, src: T)

where Self: Sized,

Transfer bytes into self from src and advance the cursor by the number of bytes written.

fn put_slice(&mut self, src: &[u8])

Transfer bytes into self from src and advance the cursor by the number of bytes written.

fn put_u8(&mut self, n: u8)

Writes an unsigned 8 bit integer to self.

fn put_i8(&mut self, n: i8)

Writes a signed 8 bit integer to self.

fn put_u16<T: ByteOrder>(&mut self, n: u16)

Writes an unsigned 16 bit integer to self in the specified byte order.

fn put_i16<T: ByteOrder>(&mut self, n: i16)

Writes a signed 16 bit integer to self in the specified byte order.

fn put_u32<T: ByteOrder>(&mut self, n: u32)

Writes an unsigned 32 bit integer to self in the specified byte order.

fn put_i32<T: ByteOrder>(&mut self, n: i32)

Writes a signed 32 bit integer to self in the specified byte order.

fn put_u64<T: ByteOrder>(&mut self, n: u64)

Writes an unsigned 64 bit integer to self in the specified byte order.

fn put_i64<T: ByteOrder>(&mut self, n: i64)

Writes a signed 64 bit integer to self in the specified byte order.

fn put_uint<T: ByteOrder>(&mut self, n: u64, nbytes: usize)

Writes an unsigned n-byte integer to self in the specified byte order.

fn put_int<T: ByteOrder>(&mut self, n: i64, nbytes: usize)

Writes a signed n-byte integer to self in the specified byte order.

fn put_f32<T: ByteOrder>(&mut self, n: f32)

Writes an IEEE754 single-precision (4 bytes) floating point number to self in the specified byte order.

fn put_f64<T: ByteOrder>(&mut self, n: f64)

Writes an IEEE754 double-precision (8 bytes) floating point number to self in the specified byte order.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adaptor for this instance of BufMut.

fn writer(self) -> Writer<Self>

where Self: Sized,

Creates an adaptor which implements the Write trait for self.

impl<T: Debug, U: Debug> Debug for Chain<T, U>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.