// Copyright 2015 The Rust Project Developers. See the COPYRIGHT // file at the top-level directory of this distribution and at // http://rust-lang.org/COPYRIGHT. // // Licensed under the Apache License, Version 2.0 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. #[cfg(feature="alloc")] use alloc::boxed::Box; use core::cmp; use io::{self, SeekFrom, Read, Write, Seek, Error, ErrorKind}; #[cfg(feature="collections")] use io::BufRead; use core::fmt; use core::mem; #[cfg(feature="collections")] use collections::string::String; #[cfg(feature="collections")] use collections::vec::Vec; // ============================================================================= // Forwarding implementations impl<'a, R: Read + ?Sized> Read for &'a mut R { #[inline] fn read(&mut self, buf: &mut [u8]) -> io::Result { (**self).read(buf) } #[cfg(feature="collections")] #[inline] fn read_to_end(&mut self, buf: &mut Vec) -> io::Result { (**self).read_to_end(buf) } #[cfg(feature="collections")] #[inline] fn read_to_string(&mut self, buf: &mut String) -> io::Result { (**self).read_to_string(buf) } #[inline] fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> { (**self).read_exact(buf) } } impl<'a, W: Write + ?Sized> Write for &'a mut W { #[inline] fn write(&mut self, buf: &[u8]) -> io::Result { (**self).write(buf) } #[inline] fn flush(&mut self) -> io::Result<()> { (**self).flush() } #[inline] fn write_all(&mut self, buf: &[u8]) -> io::Result<()> { (**self).write_all(buf) } #[inline] fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> { (**self).write_fmt(fmt) } } impl<'a, S: Seek + ?Sized> Seek for &'a mut S { #[inline] fn seek(&mut self, pos: SeekFrom) -> io::Result { (**self).seek(pos) } } #[cfg(feature="collections")] impl<'a, B: BufRead + ?Sized> BufRead for &'a mut B { #[inline] fn fill_buf(&mut self) -> io::Result<&[u8]> { (**self).fill_buf() } #[inline] fn consume(&mut self, amt: usize) { (**self).consume(amt) } #[inline] fn read_until(&mut self, byte: u8, buf: &mut Vec) -> io::Result { (**self).read_until(byte, buf) } #[inline] fn read_line(&mut self, buf: &mut String) -> io::Result { (**self).read_line(buf) } } #[cfg(feature="alloc")] impl Read for Box { #[inline] fn read(&mut self, buf: &mut [u8]) -> io::Result { (**self).read(buf) } #[cfg(feature="collections")] #[inline] fn read_to_end(&mut self, buf: &mut Vec) -> io::Result { (**self).read_to_end(buf) } #[cfg(feature="collections")] #[inline] fn read_to_string(&mut self, buf: &mut String) -> io::Result { (**self).read_to_string(buf) } #[inline] fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> { (**self).read_exact(buf) } } #[cfg(feature="alloc")] impl Write for Box { #[inline] fn write(&mut self, buf: &[u8]) -> io::Result { (**self).write(buf) } #[inline] fn flush(&mut self) -> io::Result<()> { (**self).flush() } #[inline] fn write_all(&mut self, buf: &[u8]) -> io::Result<()> { (**self).write_all(buf) } #[inline] fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> { (**self).write_fmt(fmt) } } #[cfg(feature="alloc")] impl Seek for Box { #[inline] fn seek(&mut self, pos: SeekFrom) -> io::Result { (**self).seek(pos) } } #[cfg(feature="collections")] impl BufRead for Box { #[inline] fn fill_buf(&mut self) -> io::Result<&[u8]> { (**self).fill_buf() } #[inline] fn consume(&mut self, amt: usize) { (**self).consume(amt) } #[inline] fn read_until(&mut self, byte: u8, buf: &mut Vec) -> io::Result { (**self).read_until(byte, buf) } #[inline] fn read_line(&mut self, buf: &mut String) -> io::Result { (**self).read_line(buf) } } // ============================================================================= // In-memory buffer implementations impl<'a> Read for &'a [u8] { #[inline] fn read(&mut self, buf: &mut [u8]) -> io::Result { let amt = cmp::min(buf.len(), self.len()); let (a, b) = self.split_at(amt); buf[..amt].copy_from_slice(a); *self = b; Ok(amt) } #[inline] fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> { if buf.len() > self.len() { return Err(Error::new(ErrorKind::UnexpectedEof, "failed to fill whole buffer")); } let (a, b) = self.split_at(buf.len()); buf.copy_from_slice(a); *self = b; Ok(()) } } #[cfg(feature="collections")] impl<'a> BufRead for &'a [u8] { #[inline] fn fill_buf(&mut self) -> io::Result<&[u8]> { Ok(*self) } #[inline] fn consume(&mut self, amt: usize) { *self = &self[amt..]; } } impl<'a> Write for &'a mut [u8] { #[inline] fn write(&mut self, data: &[u8]) -> io::Result { let amt = cmp::min(data.len(), self.len()); let (a, b) = mem::replace(self, &mut []).split_at_mut(amt); a.copy_from_slice(&data[..amt]); *self = b; Ok(amt) } #[inline] fn write_all(&mut self, data: &[u8]) -> io::Result<()> { if self.write(data)? == data.len() { Ok(()) } else { Err(Error::new(ErrorKind::WriteZero, "failed to write whole buffer")) } } #[inline] fn flush(&mut self) -> io::Result<()> { Ok(()) } } #[cfg(feature="collections")] impl Write for Vec { #[inline] fn write(&mut self, buf: &[u8]) -> io::Result { self.extend_from_slice(buf); Ok(buf.len()) } #[inline] fn write_all(&mut self, buf: &[u8]) -> io::Result<()> { self.extend_from_slice(buf); Ok(()) } #[inline] fn flush(&mut self) -> io::Result<()> { Ok(()) } } #[cfg(test)] mod tests { use io::prelude::*; use vec::Vec; use test; #[bench] fn bench_read_slice(b: &mut test::Bencher) { let buf = [5; 1024]; let mut dst = [0; 128]; b.iter(|| { let mut rd = &buf[..]; for _ in 0..8 { let _ = rd.read(&mut dst); test::black_box(&dst); } }) } #[bench] fn bench_write_slice(b: &mut test::Bencher) { let mut buf = [0; 1024]; let src = [5; 128]; b.iter(|| { let mut wr = &mut buf[..]; for _ in 0..8 { let _ = wr.write_all(&src); test::black_box(&wr); } }) } #[bench] fn bench_read_vec(b: &mut test::Bencher) { let buf = vec![5; 1024]; let mut dst = [0; 128]; b.iter(|| { let mut rd = &buf[..]; for _ in 0..8 { let _ = rd.read(&mut dst); test::black_box(&dst); } }) } #[bench] fn bench_write_vec(b: &mut test::Bencher) { let mut buf = Vec::with_capacity(1024); let src = [5; 128]; b.iter(|| { let mut wr = &mut buf[..]; for _ in 0..8 { let _ = wr.write_all(&src); test::black_box(&wr); } }) } }