Struct Slice 

pub struct Slice<B> { /* private fields */ }

A bounded view into an owned IoBuf or IoBufMut buffer.

Allows passing a subset of a buffer to an I/O operation without splitting or consuming it. The original buffer is reclaimed via into_inner after the operation completes.

Implementations

impl<B: IoBuf> Slice<B>

pub fn new(buf: B, begin: usize, end: usize) -> Self

Creates a new slice into buf bounded by [begin, end).

Panics

Panics if begin > end or end > buf.bytes_total().

pub fn into_inner(self) -> B

Consumes the slice and returns the underlying buffer.

pub fn len(&self) -> usize

Returns the length of initialized bytes of this slice.

pub fn is_empty(&self) -> bool

Returns true if the length of this slice is zero.

Trait Implementations

impl<B: IoBuf> AsRef<[u8]> for Slice<B>

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

Converts this type into a shared reference of the (usually inferred) input type.

impl<B: Debug> Debug for Slice<B>

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

Formats the value using the given formatter.

impl<B: IoBuf> IoBuf for Slice<B>

fn stable_ptr(&self) -> *const u8

Returns a stable pointer to the start of the initialized data.

fn bytes_init(&self) -> usize

Number of initialized bytes, valid to read.

fn bytes_total(&self) -> usize

Total capacity, including uninitialized memory. This is what gets passed to the kernel for reads.

fn slice(self, range: impl RangeBounds<usize>) -> Slice<Self>

where Self: Sized,

Returns a bounded view into this buffer.

impl<B: IoBufMut> IoBufMut for Slice<B>

fn stable_mut_ptr(&mut self) -> *mut u8

Returns a stable mutable pointer to the start of the buffer.

unsafe fn set_init(&mut self, pos: usize)

Mark the first pos bytes as initialized.

fn clear(&mut self)

Clear this buffer, setting the initialized bytes to 0.