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.
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"[..]);
Gets a reference to the first underlying Buf
.
use bytes::Buf;
let buf = (&b"hello"[..])
.chain(&b"world"[..]);
assert_eq!(buf.first_ref()[..], b"hello"[..]);
Gets a mutable reference to the first underlying Buf
.
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"[..]);
Gets a reference to the last underlying Buf
.
use bytes::Buf;
let buf = (&b"hello"[..])
.chain(&b"world"[..]);
assert_eq!(buf.last_ref()[..], b"world"[..]);
Gets a mutable reference to the last underlying Buf
.
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"[..]);
Consumes this Chain
, returning the underlying values.
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"[..]);
[+] Show hidden undocumented itemsReturns the number of bytes between the current position and the end of
the buffer. Read more
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
Advance the internal cursor of the Buf Read more
Fills dst
with potentially multiple slices starting at self
’s
current position. Read more
Returns true if there are any more bytes to consume Read more
Gets an unsigned 8 bit integer from self
. Read more
Gets a signed 8 bit integer from self
. Read more
Gets an unsigned 16 bit integer from self
in big-endian byte order. Read more
Gets an unsigned 16 bit integer from self
in little-endian byte order. Read more
Gets a signed 16 bit integer from self
in big-endian byte order. Read more
Gets a signed 16 bit integer from self
in little-endian byte order. Read more
Gets an unsigned 32 bit integer from self
in the big-endian byte order. Read more
Gets an unsigned 32 bit integer from self
in the little-endian byte order. Read more
Gets a signed 32 bit integer from self
in big-endian byte order. Read more
Gets a signed 32 bit integer from self
in little-endian byte order. Read more
Gets an unsigned 64 bit integer from self
in big-endian byte order. Read more
Gets an unsigned 64 bit integer from self
in little-endian byte order. Read more
Gets a signed 64 bit integer from self
in big-endian byte order. Read more
Gets a signed 64 bit integer from self
in little-endian byte order. Read more
Gets an unsigned 128 bit integer from self
in big-endian byte order. Read more
Gets an unsigned 128 bit integer from self
in little-endian byte order. Read more
Gets a signed 128 bit integer from self
in big-endian byte order. Read more
Gets a signed 128 bit integer from self
in little-endian byte order. Read more
Gets an unsigned n-byte integer from self
in big-endian byte order. Read more
Gets an unsigned n-byte integer from self
in little-endian byte order. Read more
Gets a signed n-byte integer from self
in big-endian byte order. Read more
Gets a signed n-byte integer from self
in little-endian byte order. Read more
Gets an IEEE754 single-precision (4 bytes) floating point number from
self
in big-endian byte order. Read more
Gets an IEEE754 single-precision (4 bytes) floating point number from
self
in little-endian byte order. Read more
Gets an IEEE754 double-precision (8 bytes) floating point number from
self
in big-endian byte order. Read more
Gets an IEEE754 double-precision (8 bytes) floating point number from
self
in little-endian byte order. Read more
Consumes len
bytes inside self and returns new instance of Bytes
with this data. Read more
Creates an adaptor which will read at most limit
bytes from self
. Read more
Creates an adaptor which will chain this buffer with another. Read more
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][+]
[+] Show hidden undocumented itemsfn 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>ⓘ 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][+]
impl<T, U> IntoIterator for Chain<T, U> where
T: Buf,
U: Buf,
[src][+]
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,