Struct tokio_core::io::EasyBuf

pub struct EasyBuf { /* fields omitted */ }

Deprecated

: moved to the tokio-io crate

A reference counted buffer of bytes.

An EasyBuf is a representation of a byte buffer where sub-slices of it can be handed out efficiently, each with a 'static lifetime which keeps the data alive. The buffer also supports mutation but may require bytes to be copied to complete the operation.

Methods

impl EasyBuf

fn new() -> EasyBuf

Deprecated

: moved to the tokio-io crate

Creates a new EasyBuf with no data and the default capacity.

fn with_capacity(cap: usize) -> EasyBuf

Deprecated

: moved to the tokio-io crate

Creates a new EasyBuf with cap capacity.

fn len(&self) -> usize

Deprecated

: moved to the tokio-io crate

Returns the number of bytes contained in this EasyBuf.

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

Deprecated

: moved to the tokio-io crate

Returns the inner contents of this EasyBuf as a slice.

fn split_off(&mut self, at: usize) -> EasyBuf

Deprecated

: moved to the tokio-io crate

Splits the buffer into two at the given index.

Afterwards self contains elements [0, at), and the returned EasyBuf contains elements [at, len).

This is an O(1) operation that just increases the reference count and sets a few indexes.

Panics

Panics if at > len

fn drain_to(&mut self, at: usize) -> EasyBuf

Deprecated

: moved to the tokio-io crate

Splits the buffer into two at the given index.

Afterwards self contains elements [at, len), and the returned EasyBuf contains elements [0, at).

This is an O(1) operation that just increases the reference count and sets a few indexes.

Panics

Panics if at > len

fn get_mut(&mut self) -> EasyBufMut

Deprecated

: moved to the tokio-io crate

Returns a mutable reference to the underlying growable buffer of bytes.

If this EasyBuf is the only instance pointing at the underlying buffer of bytes, a direct mutable reference will be returned. Otherwise the contents of this EasyBuf will be reallocated in a fresh Vec<u8> allocation with the same capacity as an EasyBuf created with EasyBuf::new(), and that allocation will be returned.

This operation is not O(1) as it may clone the entire contents of this buffer.

The returned EasyBufMut type implement Deref and DerefMut to Vec<u8> can the byte buffer can be manipulated using the standard Vec<u8> methods.

Trait Implementations

impl Clone for EasyBuf

fn clone(&self) -> EasyBuf

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Eq for EasyBuf

impl AsRef<[u8]> for EasyBuf

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

Performs the conversion.

impl From<Vec<u8>> for EasyBuf

fn from(vec: Vec<u8>) -> EasyBuf

Performs the conversion.

impl<T: AsRef<[u8]>> PartialEq<T> for EasyBuf

fn eq(&self, other: &T) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Ord for EasyBuf

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

🔬 This is a nightly-only experimental API. (ord_max_min)

Compares and returns the minimum of two values.

impl<T: AsRef<[u8]>> PartialOrd<T> for EasyBuf

fn partial_cmp(&self, other: &T) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Hash for EasyBuf

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Debug for EasyBuf

fn fmt(&self, formatter: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Into<Vec<u8>> for EasyBuf

fn into(self) -> Vec<u8>

Performs the conversion.