use {Buf, BufMut}; use iovec::IoVec; /// A `Chain` sequences two buffers. /// /// `Chain` is an adapter that links two underlying buffers and provides a /// continous 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, IntoBuf}; /// use bytes::buf::Chain; /// /// let buf = Bytes::from(&b"hello "[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// let full: Bytes = buf.collect(); /// assert_eq!(full[..], b"hello world"[..]); /// ``` /// /// [`Buf::chain`]: trait.Buf.html#method.chain /// [`Buf`]: trait.Buf.html /// [`BufMut`]: trait.BufMut.html #[derive(Debug)] pub struct Chain { a: T, b: U, } impl Chain { /// Creates a new `Chain` sequencing the provided values. /// /// # Examples /// /// ``` /// use bytes::BytesMut; /// use bytes::buf::Chain; /// /// let buf = Chain::new( /// BytesMut::with_capacity(1024), /// BytesMut::with_capacity(1024)); /// /// // Use the chained buffer /// ``` pub fn new(a: T, b: U) -> Chain { Chain { a: a, b: b, } } /// Gets a reference to the first underlying `Buf`. /// /// # Examples /// /// ``` /// use bytes::{Bytes, Buf, IntoBuf}; /// /// let buf = Bytes::from(&b"hello"[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// assert_eq!(buf.first_ref().get_ref()[..], b"hello"[..]); /// ``` pub fn first_ref(&self) -> &T { &self.a } /// Gets a mutable reference to the first underlying `Buf`. /// /// # Examples /// /// ``` /// use bytes::{Bytes, Buf, IntoBuf}; /// /// let mut buf = Bytes::from(&b"hello "[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// buf.first_mut().set_position(1); /// /// let full: Bytes = buf.collect(); /// assert_eq!(full[..], b"ello world"[..]); /// ``` pub fn first_mut(&mut self) -> &mut T { &mut self.a } /// Gets a reference to the last underlying `Buf`. /// /// # Examples /// /// ``` /// use bytes::{Bytes, Buf, IntoBuf}; /// /// let buf = Bytes::from(&b"hello"[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// assert_eq!(buf.last_ref().get_ref()[..], b"world"[..]); /// ``` pub fn last_ref(&self) -> &U { &self.b } /// Gets a mutable reference to the last underlying `Buf`. /// /// # Examples /// /// ``` /// use bytes::{Bytes, Buf, IntoBuf}; /// /// let mut buf = Bytes::from(&b"hello "[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// buf.last_mut().set_position(1); /// /// let full: Bytes = buf.collect(); /// assert_eq!(full[..], b"hello orld"[..]); /// ``` pub fn last_mut(&mut self) -> &mut U { &mut self.b } /// Consumes this `Chain`, returning the underlying values. /// /// # Examples /// /// ``` /// use bytes::{Bytes, Buf, IntoBuf}; /// /// let buf = Bytes::from(&b"hello"[..]).into_buf() /// .chain(Bytes::from(&b"world"[..])); /// /// let (first, last) = buf.into_inner(); /// assert_eq!(first.get_ref()[..], b"hello"[..]); /// assert_eq!(last.get_ref()[..], b"world"[..]); /// ``` pub fn into_inner(self) -> (T, U) { (self.a, self.b) } } impl Buf for Chain where T: Buf, U: Buf, { fn remaining(&self) -> usize { self.a.remaining() + self.b.remaining() } fn bytes(&self) -> &[u8] { if self.a.has_remaining() { self.a.bytes() } else { self.b.bytes() } } fn advance(&mut self, mut cnt: usize) { let a_rem = self.a.remaining(); if a_rem != 0 { if a_rem >= cnt { self.a.advance(cnt); return; } // Consume what is left of a self.a.advance(a_rem); cnt -= a_rem; } self.b.advance(cnt); } fn bytes_vec<'a>(&'a self, dst: &mut [&'a IoVec]) -> usize { let mut n = self.a.bytes_vec(dst); n += self.b.bytes_vec(&mut dst[n..]); n } } impl BufMut for Chain where T: BufMut, U: BufMut, { fn remaining_mut(&self) -> usize { self.a.remaining_mut() + self.b.remaining_mut() } unsafe fn bytes_mut(&mut self) -> &mut [u8] { if self.a.has_remaining_mut() { self.a.bytes_mut() } else { self.b.bytes_mut() } } unsafe fn advance_mut(&mut self, mut cnt: usize) { let a_rem = self.a.remaining_mut(); if a_rem != 0 { if a_rem >= cnt { self.a.advance_mut(cnt); return; } // Consume what is left of a self.a.advance_mut(a_rem); cnt -= a_rem; } self.b.advance_mut(cnt); } unsafe fn bytes_vec_mut<'a>(&'a mut self, dst: &mut [&'a mut IoVec]) -> usize { let mut n = self.a.bytes_vec_mut(dst); n += self.b.bytes_vec_mut(&mut dst[n..]); n } }