1 //! Utilities for working with buffers. 2 //! 3 //! A buffer is any structure that contains a sequence of bytes. The bytes may 4 //! or may not be stored in contiguous memory. This module contains traits used 5 //! to abstract over buffers as well as utilities for working with buffer types. 6 //! 7 //! # `Buf`, `BufMut` 8 //! 9 //! These are the two foundational traits for abstractly working with buffers. 10 //! They can be thought as iterators for byte structures. They offer additional 11 //! performance over `Iterator` by providing an API optimized for byte slices. 12 //! 13 //! See [`Buf`] and [`BufMut`] for more details. 14 //! 15 //! [rope]: https://en.wikipedia.org/wiki/Rope_(data_structure) 16 //! [`Buf`]: trait.Buf.html 17 //! [`BufMut`]: trait.BufMut.html 18 19 mod buf_impl; 20 mod buf_mut; 21 pub mod ext; 22 mod iter; 23 mod vec_deque; 24 25 pub use self::buf_impl::Buf; 26 pub use self::buf_mut::BufMut; 27 pub use self::ext::{BufExt, BufMutExt}; 28 #[cfg(feature = "std")] 29 pub use self::buf_mut::IoSliceMut; 30 pub use self::iter::IntoIter; 31 32