Struct bytes_utils::SegmentedSlice

pub struct SegmentedSlice<'a, B> { /* fields omitted */ }

A consumable view of a sequence of buffers.

This allows viewing a sequence of buffers as one buffer, without copying the bytes over. Unlike the SegmentedBuf, this doesn't allow for appending more buffers and doesn't drop the buffers as they are exhausted (though they all get exhausted, no leftovers are kept in them as the caller advances through it). On the other hand, it doesn't require an internal allocation in the form of VecDeque and can be based on any kind of slice.

Example

let mut buffers = [b"Hello" as &[_], b"", b" ", b"", b"World"];
let buf = SegmentedSlice::new(&mut buffers);

assert_eq!(11, buf.remaining());
assert_eq!(b"Hello", buf.chunk());

let mut out = String::new();
buf.reader().read_to_string(&mut out).expect("Doesn't cause IO errors");
assert_eq!("Hello World", out);

Optimizations

The copy_to_bytes method tries to avoid copies by delegating into the underlying buffer if possible (if the whole request can be fulfilled using only a single buffer). If that one is optimized (for example, the Bytes returns a shared instance instead of making a copy), the copying is avoided. If the request is across a buffer boundary, a copy is made.

The chunks_vectored will properly output as many slices as possible, not just 1 as the default implementation does.

Implementations

impl<'a, B: Buf> SegmentedSlice<'a, B>

pub fn new(bufs: &'a mut [B]) -> Self

Creates a new buffer out of a slice of buffers.

The buffers will then be taken in order to form one bigger buffer.

Each of the buffers in turn will be exhausted using its advance before proceeding to the next one. Note that the buffers are not dropped (unlike with SegmentedBuf).

Trait Implementations

impl<'a, B: Buf> Buf for SegmentedSlice<'a, B>

fn remaining(&self) -> usize

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

fn chunk(&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, mut cnt: usize)

Advance the internal cursor of the Buf

fn copy_to_bytes(&mut self, len: usize) -> Bytes

Consumes len bytes inside self and returns new instance of Bytes with this data.

fn chunks_vectored<'s>(&'s self, dst: &mut [IoSlice<'s>]) -> usize

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

pub fn has_remaining(&self) -> bool

Returns true if there are any more bytes to consume

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

Copies bytes from self into dst.

pub fn get_u8(&mut self) -> u8

Gets an unsigned 8 bit integer from self.

pub fn get_i8(&mut self) -> i8

Gets a signed 8 bit integer from self.

pub fn get_u16(&mut self) -> u16

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

pub fn get_u16_le(&mut self) -> u16

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

pub fn get_i16(&mut self) -> i16

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

pub fn get_i16_le(&mut self) -> i16

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

pub fn get_u32(&mut self) -> u32

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

pub fn get_u32_le(&mut self) -> u32

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

pub fn get_i32(&mut self) -> i32

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

pub fn get_i32_le(&mut self) -> i32

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

pub fn get_u64(&mut self) -> u64

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

pub fn get_u64_le(&mut self) -> u64

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

pub fn get_i64(&mut self) -> i64

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

pub fn get_i64_le(&mut self) -> i64

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

pub fn get_u128(&mut self) -> u128

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

pub fn get_u128_le(&mut self) -> u128

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

pub fn get_i128(&mut self) -> i128

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

pub fn get_i128_le(&mut self) -> i128

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

pub fn get_uint(&mut self, nbytes: usize) -> u64

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

pub fn get_uint_le(&mut self, nbytes: usize) -> u64

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

pub fn get_int(&mut self, nbytes: usize) -> i64

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

pub fn get_int_le(&mut self, nbytes: usize) -> i64

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

pub fn get_f32(&mut self) -> f32

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

pub fn get_f32_le(&mut self) -> f32

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

pub fn get_f64(&mut self) -> f64

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

pub fn get_f64_le(&mut self) -> f64

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

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

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

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

Creates an adaptor which will chain this buffer with another.

pub fn reader(self) -> Reader<Self>

Creates an adaptor which implements the Read trait for self.

impl<'a, B: Debug> Debug for SegmentedSlice<'a, B>

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

Formats the value using the given formatter.

impl<'a, B: Default> Default for SegmentedSlice<'a, B>

fn default() -> SegmentedSlice<'a, B>

Returns the "default value" for a type.