Struct bytes::buf::ext::Chain

[+] Show declaration

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

[−] Expand description

A Chain sequences two buffers.

Chain is an adapter that links two underlying buffers and provides a continuous 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 bytes::{Bytes, Buf, buf::BufExt};

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

let full: Bytes = buf.to_bytes();
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.

pub fn first_ref(&self) -> &T[−]

Gets a reference to the first underlying Buf.

Examples

use bytes::buf::BufExt;

let buf = (&b"hello"[..])
    .chain(&b"world"[..]);

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

pub fn first_mut(&mut self) -> &mut T[−]

Gets a mutable reference to the first underlying Buf.

Examples

use bytes::{Buf, buf::BufExt};

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

buf.first_mut().advance(1);

let full = buf.to_bytes();
assert_eq!(full, b"elloworld"[..]);

pub fn last_ref(&self) -> &U[−]

Gets a reference to the last underlying Buf.

Examples

use bytes::buf::BufExt;

let buf = (&b"hello"[..])
    .chain(&b"world"[..]);

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

pub fn last_mut(&mut self) -> &mut U[−]

Gets a mutable reference to the last underlying Buf.

Examples

use bytes::{Buf, buf::BufExt};

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

buf.last_mut().advance(1);

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

pub fn into_inner(self) -> (T, U)[−]

Consumes this Chain, returning the underlying values.

Examples

use bytes::buf::BufExt;

let chain = (&b"hello"[..])
    .chain(&b"world"[..]);

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

Trait Implementations

impl<T, U> Buf for Chain<T, U> where
    T: Buf,
    U: Buf, [+]

[+] Show hidden undocumented items

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(). Note that this can return shorter slice (this allows non-continuous internal representation).

fn advance(&mut self, cnt: usize)[−]

Advance the internal cursor of the Buf

fn bytes_vectored<'a>(&'a self, dst: &mut [IoSlice<'a>]) -> usize[−]

Fills dst with potentially multiple slices starting at self's current position.

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(&mut self) -> u16[−]

Gets an unsigned 16 bit integer from self in big-endian byte order.

fn get_u16_le(&mut self) -> u16[−]

Gets an unsigned 16 bit integer from self in little-endian byte order.

fn get_i16(&mut self) -> i16[−]

Gets a signed 16 bit integer from self in big-endian byte order.

fn get_i16_le(&mut self) -> i16[−]

Gets a signed 16 bit integer from self in little-endian byte order.

fn get_u32(&mut self) -> u32[−]

Gets an unsigned 32 bit integer from self in the big-endian byte order.

fn get_u32_le(&mut self) -> u32[−]

Gets an unsigned 32 bit integer from self in the little-endian byte order.

fn get_i32(&mut self) -> i32[−]

Gets a signed 32 bit integer from self in big-endian byte order.

fn get_i32_le(&mut self) -> i32[−]

Gets a signed 32 bit integer from self in little-endian byte order.

fn get_u64(&mut self) -> u64[−]

Gets an unsigned 64 bit integer from self in big-endian byte order.

fn get_u64_le(&mut self) -> u64[−]

Gets an unsigned 64 bit integer from self in little-endian byte order.

fn get_i64(&mut self) -> i64[−]

Gets a signed 64 bit integer from self in big-endian byte order.

fn get_i64_le(&mut self) -> i64[−]

Gets a signed 64 bit integer from self in little-endian byte order.

fn get_u128(&mut self) -> u128[−]

Gets an unsigned 128 bit integer from self in big-endian byte order.

fn get_u128_le(&mut self) -> u128[−]

Gets an unsigned 128 bit integer from self in little-endian byte order.

fn get_i128(&mut self) -> i128[−]

Gets a signed 128 bit integer from self in big-endian byte order.

fn get_i128_le(&mut self) -> i128[−]

Gets a signed 128 bit integer from self in little-endian byte order.

fn get_uint(&mut self, nbytes: usize) -> u64[−]

Gets an unsigned n-byte integer from self in big-endian byte order.

fn get_uint_le(&mut self, nbytes: usize) -> u64[−]

Gets an unsigned n-byte integer from self in little-endian byte order.

fn get_int(&mut self, nbytes: usize) -> i64[−]

Gets a signed n-byte integer from self in big-endian byte order.

fn get_int_le(&mut self, nbytes: usize) -> i64[−]

Gets a signed n-byte integer from self in little-endian byte order.

fn get_f32(&mut self) -> f32[−]

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

fn get_f32_le(&mut self) -> f32[−]

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

fn get_f64(&mut self) -> f64[−]

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

fn get_f64_le(&mut self) -> f64[−]

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

fn to_bytes(&mut self) -> Bytes[−]

Consumes remaining bytes inside self and returns new instance of Bytes

impl<T, U> BufMut for Chain<T, U> where
    T: BufMut,
    U: BufMut, [+]

[+] Show hidden undocumented items

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.

fn bytes_mut(&mut self) -> &mut [MaybeUninit<u8>][−]

Returns a mutable slice starting at the current BufMut position and of length between 0 and BufMut::remaining_mut(). Note that this can be shorter than the whole remainder of the buffer (this allows non-continuous implementation).

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

Advance the internal cursor of the BufMut

fn bytes_vectored_mut<'a>(&'a mut self, dst: &mut [IoSliceMut<'a>]) -> usize[−]

Fills dst with potentially multiple mutable slices starting at self's current position.

fn has_remaining_mut(&self) -> bool[−]

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

fn put<T: Buf>(&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(&mut self, n: u16)[−]

Writes an unsigned 16 bit integer to self in big-endian byte order.

fn put_u16_le(&mut self, n: u16)[−]

Writes an unsigned 16 bit integer to self in little-endian byte order.

fn put_i16(&mut self, n: i16)[−]

Writes a signed 16 bit integer to self in big-endian byte order.

fn put_i16_le(&mut self, n: i16)[−]

Writes a signed 16 bit integer to self in little-endian byte order.

fn put_u32(&mut self, n: u32)[−]

Writes an unsigned 32 bit integer to self in big-endian byte order.

fn put_u32_le(&mut self, n: u32)[−]

Writes an unsigned 32 bit integer to self in little-endian byte order.

fn put_i32(&mut self, n: i32)[−]

Writes a signed 32 bit integer to self in big-endian byte order.

fn put_i32_le(&mut self, n: i32)[−]

Writes a signed 32 bit integer to self in little-endian byte order.

fn put_u64(&mut self, n: u64)[−]

Writes an unsigned 64 bit integer to self in the big-endian byte order.

fn put_u64_le(&mut self, n: u64)[−]

Writes an unsigned 64 bit integer to self in little-endian byte order.

fn put_i64(&mut self, n: i64)[−]

Writes a signed 64 bit integer to self in the big-endian byte order.

fn put_i64_le(&mut self, n: i64)[−]

Writes a signed 64 bit integer to self in little-endian byte order.

fn put_u128(&mut self, n: u128)[−]

Writes an unsigned 128 bit integer to self in the big-endian byte order.

fn put_u128_le(&mut self, n: u128)[−]

Writes an unsigned 128 bit integer to self in little-endian byte order.

fn put_i128(&mut self, n: i128)[−]

Writes a signed 128 bit integer to self in the big-endian byte order.

fn put_i128_le(&mut self, n: i128)[−]

Writes a signed 128 bit integer to self in little-endian byte order.

fn put_uint(&mut self, n: u64, nbytes: usize)[−]

Writes an unsigned n-byte integer to self in big-endian byte order.

fn put_uint_le(&mut self, n: u64, nbytes: usize)[−]

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

fn put_int(&mut self, n: i64, nbytes: usize)[−]

Writes a signed n-byte integer to self in big-endian byte order.

fn put_int_le(&mut self, n: i64, nbytes: usize)[−]

Writes a signed n-byte integer to self in little-endian byte order.

fn put_f32(&mut self, n: f32)[−]

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

fn put_f32_le(&mut self, n: f32)[−]

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

fn put_f64(&mut self, n: f64)[−]

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

fn put_f64_le(&mut self, n: f64)[−]

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

impl<T: Debug, U: Debug> Debug for Chain<T, U>[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl<T, U> IntoIterator for Chain<T, U> where
    T: Buf,
    U: Buf, [+]

[+] Show hidden undocumented items

type Item = u8

The type of the elements being iterated over.

type IntoIter = IntoIter<Chain<T, U>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter[−]

Creates an iterator from a value.