# Struct bytes::buf::Chain [−] [src]

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

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};

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

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

## Implementations

### `impl<T, U> Chain<T, U>` [src]

#### `pub fn first_ref(&self) -> &T` [src]

Gets a reference to the first underlying `Buf`.

# Examples

    use bytes::Buf;

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

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

#### `pub fn first_mut(&mut self) -> &mut T` [src]

Gets a mutable reference to the first underlying `Buf`.

# Examples

    use bytes::Buf;

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

    buf.first_mut().advance(1);

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

#### `pub fn last_ref(&self) -> &U` [src]

Gets a reference to the last underlying `Buf`.

# Examples

    use bytes::Buf;

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

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

#### `pub fn last_mut(&mut self) -> &mut U` [src]

Gets a mutable reference to the last underlying `Buf`.

# Examples

    use bytes::Buf;

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

    buf.last_mut().advance(1);

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

#### `pub fn into_inner(self) -> (T, U)` [src]

Consumes this `Chain`, returning the underlying values.

# Examples

    use bytes::Buf;

    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,` [src]

#### `fn remaining(&self) -> usize` [src]

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

#### `fn chunk(&self) -> &[u8]ⓘ

### Notable traits for &'_ [u8]

`impl<'_> Read for &'_ [u8]impl<'_> Write for &'_ mut [u8]`
` [src]

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). Read more

#### `fn advance(&mut self, cnt: usize)` [src]

Advance the internal cursor of the Buf Read more

#### `fn chunks_vectored<'a>(&'a self, dst: &mut [IoSlice<'a>]) -> usize` [src]

Fills `dst` with potentially multiple slices starting at `self`’s current position. Read more

#### `fn has_remaining(&self) -> bool` [src]

Returns true if there are any more bytes to consume Read more

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

Copies bytes from `self` into `dst`. Read more

#### `fn get_u8(&mut self) -> u8` [src]

Gets an unsigned 8 bit integer from `self`. Read more

#### `fn get_i8(&mut self) -> i8` [src]

Gets a signed 8 bit integer from `self`. Read more

#### `fn get_u16(&mut self) -> u16` [src]

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

#### `fn get_u16_le(&mut self) -> u16` [src]

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

#### `fn get_i16(&mut self) -> i16` [src]

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

#### `fn get_i16_le(&mut self) -> i16` [src]

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

#### `fn get_u32(&mut self) -> u32` [src]

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

#### `fn get_u32_le(&mut self) -> u32` [src]

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

#### `fn get_i32(&mut self) -> i32` [src]

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

#### `fn get_i32_le(&mut self) -> i32` [src]

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

#### `fn get_u64(&mut self) -> u64` [src]

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

#### `fn get_u64_le(&mut self) -> u64` [src]

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

#### `fn get_i64(&mut self) -> i64` [src]

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

#### `fn get_i64_le(&mut self) -> i64` [src]

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

#### `fn get_u128(&mut self) -> u128` [src]

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

#### `fn get_u128_le(&mut self) -> u128` [src]

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

#### `fn get_i128(&mut self) -> i128` [src]

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

#### `fn get_i128_le(&mut self) -> i128` [src]

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

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

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

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

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

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

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

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

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

#### `fn get_f32(&mut self) -> f32` [src]

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

#### `fn get_f32_le(&mut self) -> f32` [src]

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

#### `fn get_f64(&mut self) -> f64` [src]

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

#### `fn get_f64_le(&mut self) -> f64` [src]

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

#### `fn copy_to_bytes(&mut self, len: usize) -> Bytes` [src]

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

#### `fn take(self, limit: usize) -> Take<Self> where
Self: Sized,` [src]

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

#### `fn chain<U: Buf>(self, next: U) -> Chain<Self, U> where
Self: Sized,` [src]

Creates an adaptor which will chain this buffer with another. Read more

#### `fn reader(self) -> Reader<Self>ⓘ

### Notable traits for Reader<B>

`impl<B: Buf + Sized> Read for Reader<B>`
where
Self: Sized,` [src]

Creates an adaptor which implements the `Read` trait for `self`. Read more

### `impl<T, U> BufMut for Chain<T, U> where
T: BufMut,
U: BufMut,` [src]

#### `fn remaining_mut(&self) -> usize` [src]

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

#### `fn chunk_mut(&mut self) -> &mut UninitSlice` [src]

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). Read more

#### `unsafe fn advance_mut(&mut self, cnt: usize)` [src]

Advance the internal cursor of the BufMut Read more

#### `fn has_remaining_mut(&self) -> bool` [src]

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

#### `fn put<T: Buf>(&mut self, src: T) where
Self: Sized,` [src]

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

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

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

#### `fn put_u8(&mut self, n: u8)` [src]

Writes an unsigned 8 bit integer to `self`. Read more

#### `fn put_i8(&mut self, n: i8)` [src]

Writes a signed 8 bit integer to `self`. Read more

#### `fn put_u16(&mut self, n: u16)` [src]

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

#### `fn put_u16_le(&mut self, n: u16)` [src]

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

#### `fn put_i16(&mut self, n: i16)` [src]

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

#### `fn put_i16_le(&mut self, n: i16)` [src]

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

#### `fn put_u32(&mut self, n: u32)` [src]

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

#### `fn put_u32_le(&mut self, n: u32)` [src]

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

#### `fn put_i32(&mut self, n: i32)` [src]

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

#### `fn put_i32_le(&mut self, n: i32)` [src]

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

#### `fn put_u64(&mut self, n: u64)` [src]

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

#### `fn put_u64_le(&mut self, n: u64)` [src]

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

#### `fn put_i64(&mut self, n: i64)` [src]

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

#### `fn put_i64_le(&mut self, n: i64)` [src]

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

#### `fn put_u128(&mut self, n: u128)` [src]

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

#### `fn put_u128_le(&mut self, n: u128)` [src]

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

#### `fn put_i128(&mut self, n: i128)` [src]

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

#### `fn put_i128_le(&mut self, n: i128)` [src]

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

#### `fn put_uint(&mut self, n: u64, nbytes: usize)` [src]

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

#### `fn put_uint_le(&mut self, n: u64, nbytes: usize)` [src]

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

#### `fn put_int(&mut self, n: i64, nbytes: usize)` [src]

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

#### `fn put_int_le(&mut self, n: i64, nbytes: usize)` [src]

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

#### `fn put_f32(&mut self, n: f32)` [src]

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

#### `fn put_f32_le(&mut self, n: f32)` [src]

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

#### `fn put_f64(&mut self, n: f64)` [src]

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

#### `fn put_f64_le(&mut self, n: f64)` [src]

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

#### `fn limit(self, limit: usize) -> Limit<Self> where
Self: Sized,` [src]

Creates an adaptor which can write at most `limit` bytes to `self`. Read more

#### `fn writer(self) -> Writer<Self>ⓘ

### Notable traits for Writer<B>

`impl<B: BufMut + Sized> Write for Writer<B>`
where
Self: Sized,` [src]

Creates an adaptor which implements the `Write` trait for `self`. Read more

#### `fn chain_mut<U: BufMut>(self, next: U) -> Chain<Self, U> where
Self: Sized,` [src]

Creates an adapter which will chain this buffer with another. Read more

### `impl<T: Debug, U: Debug> Debug for Chain<T, U>` [src]

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

Formats the value using the given formatter. Read more

### `impl<T, U> IntoIterator for Chain<T, U> where
T: Buf,
U: Buf,` [src]

#### `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` [src]

Creates an iterator from a value. Read more

## Auto Trait Implementations

### `impl<T, U> RefUnwindSafe for Chain<T, U> where
T: RefUnwindSafe,
U: RefUnwindSafe,`

### `impl<T, U> Send for Chain<T, U> where
T: Send,
U: Send,`

### `impl<T, U> Sync for Chain<T, U> where
T: Sync,
U: Sync,`

### `impl<T, U> Unpin for Chain<T, U> where
T: Unpin,
U: Unpin,`

### `impl<T, U> UnwindSafe for Chain<T, U> where
T: UnwindSafe,
U: UnwindSafe,`

## Blanket Implementations

### `impl<T> Any for T where
T: 'static + ?Sized,` [src]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T` [src]

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

### `impl<T, U> Into<U> for T where
U: From<T>,` [src]

#### `pub fn into(self) -> U` [src]

Performs the conversion.

### `impl<T, U> TryFrom<U> for T where
U: Into<T>,` [src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where
U: TryFrom<T>,` [src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.