impls.rs 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289
  1. // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
  2. // file at the top-level directory of this distribution and at
  3. // http://rust-lang.org/COPYRIGHT.
  4. //
  5. // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
  6. // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
  7. // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
  8. // option. This file may not be copied, modified, or distributed
  9. // except according to those terms.
  10. #[cfg(feature="alloc")] use alloc::boxed::Box;
  11. use core::cmp;
  12. use io::{self, SeekFrom, Read, Write, Seek, Error, ErrorKind};
  13. #[cfg(feature="collections")] use io::BufRead;
  14. use core::fmt;
  15. use core::mem;
  16. #[cfg(feature="collections")] use collections::string::String;
  17. #[cfg(feature="collections")] use collections::vec::Vec;
  18. // =============================================================================
  19. // Forwarding implementations
  20. impl<'a, R: Read + ?Sized> Read for &'a mut R {
  21. #[inline]
  22. fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
  23. (**self).read(buf)
  24. }
  25. #[cfg(feature="collections")]
  26. #[inline]
  27. fn read_to_end(&mut self, buf: &mut Vec<u8>) -> io::Result<usize> {
  28. (**self).read_to_end(buf)
  29. }
  30. #[cfg(feature="collections")]
  31. #[inline]
  32. fn read_to_string(&mut self, buf: &mut String) -> io::Result<usize> {
  33. (**self).read_to_string(buf)
  34. }
  35. #[inline]
  36. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  37. (**self).read_exact(buf)
  38. }
  39. }
  40. impl<'a, W: Write + ?Sized> Write for &'a mut W {
  41. #[inline]
  42. fn write(&mut self, buf: &[u8]) -> io::Result<usize> { (**self).write(buf) }
  43. #[inline]
  44. fn flush(&mut self) -> io::Result<()> { (**self).flush() }
  45. #[inline]
  46. fn write_all(&mut self, buf: &[u8]) -> io::Result<()> {
  47. (**self).write_all(buf)
  48. }
  49. #[inline]
  50. fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> {
  51. (**self).write_fmt(fmt)
  52. }
  53. }
  54. impl<'a, S: Seek + ?Sized> Seek for &'a mut S {
  55. #[inline]
  56. fn seek(&mut self, pos: SeekFrom) -> io::Result<u64> { (**self).seek(pos) }
  57. }
  58. #[cfg(feature="collections")]
  59. impl<'a, B: BufRead + ?Sized> BufRead for &'a mut B {
  60. #[inline]
  61. fn fill_buf(&mut self) -> io::Result<&[u8]> { (**self).fill_buf() }
  62. #[inline]
  63. fn consume(&mut self, amt: usize) { (**self).consume(amt) }
  64. #[inline]
  65. fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> io::Result<usize> {
  66. (**self).read_until(byte, buf)
  67. }
  68. #[inline]
  69. fn read_line(&mut self, buf: &mut String) -> io::Result<usize> {
  70. (**self).read_line(buf)
  71. }
  72. }
  73. #[cfg(feature="alloc")]
  74. impl<R: Read + ?Sized> Read for Box<R> {
  75. #[inline]
  76. fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
  77. (**self).read(buf)
  78. }
  79. #[cfg(feature="collections")]
  80. #[inline]
  81. fn read_to_end(&mut self, buf: &mut Vec<u8>) -> io::Result<usize> {
  82. (**self).read_to_end(buf)
  83. }
  84. #[cfg(feature="collections")]
  85. #[inline]
  86. fn read_to_string(&mut self, buf: &mut String) -> io::Result<usize> {
  87. (**self).read_to_string(buf)
  88. }
  89. #[inline]
  90. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  91. (**self).read_exact(buf)
  92. }
  93. }
  94. #[cfg(feature="alloc")]
  95. impl<W: Write + ?Sized> Write for Box<W> {
  96. #[inline]
  97. fn write(&mut self, buf: &[u8]) -> io::Result<usize> { (**self).write(buf) }
  98. #[inline]
  99. fn flush(&mut self) -> io::Result<()> { (**self).flush() }
  100. #[inline]
  101. fn write_all(&mut self, buf: &[u8]) -> io::Result<()> {
  102. (**self).write_all(buf)
  103. }
  104. #[inline]
  105. fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> {
  106. (**self).write_fmt(fmt)
  107. }
  108. }
  109. #[cfg(feature="alloc")]
  110. impl<S: Seek + ?Sized> Seek for Box<S> {
  111. #[inline]
  112. fn seek(&mut self, pos: SeekFrom) -> io::Result<u64> { (**self).seek(pos) }
  113. }
  114. #[cfg(feature="collections")]
  115. impl<B: BufRead + ?Sized> BufRead for Box<B> {
  116. #[inline]
  117. fn fill_buf(&mut self) -> io::Result<&[u8]> { (**self).fill_buf() }
  118. #[inline]
  119. fn consume(&mut self, amt: usize) { (**self).consume(amt) }
  120. #[inline]
  121. fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> io::Result<usize> {
  122. (**self).read_until(byte, buf)
  123. }
  124. #[inline]
  125. fn read_line(&mut self, buf: &mut String) -> io::Result<usize> {
  126. (**self).read_line(buf)
  127. }
  128. }
  129. // =============================================================================
  130. // In-memory buffer implementations
  131. impl<'a> Read for &'a [u8] {
  132. #[inline]
  133. fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
  134. let amt = cmp::min(buf.len(), self.len());
  135. let (a, b) = self.split_at(amt);
  136. buf[..amt].copy_from_slice(a);
  137. *self = b;
  138. Ok(amt)
  139. }
  140. #[inline]
  141. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  142. if buf.len() > self.len() {
  143. return Err(Error::new(ErrorKind::UnexpectedEof,
  144. "failed to fill whole buffer"));
  145. }
  146. let (a, b) = self.split_at(buf.len());
  147. buf.copy_from_slice(a);
  148. *self = b;
  149. Ok(())
  150. }
  151. }
  152. #[cfg(feature="collections")]
  153. impl<'a> BufRead for &'a [u8] {
  154. #[inline]
  155. fn fill_buf(&mut self) -> io::Result<&[u8]> { Ok(*self) }
  156. #[inline]
  157. fn consume(&mut self, amt: usize) { *self = &self[amt..]; }
  158. }
  159. impl<'a> Write for &'a mut [u8] {
  160. #[inline]
  161. fn write(&mut self, data: &[u8]) -> io::Result<usize> {
  162. let amt = cmp::min(data.len(), self.len());
  163. let (a, b) = mem::replace(self, &mut []).split_at_mut(amt);
  164. a.copy_from_slice(&data[..amt]);
  165. *self = b;
  166. Ok(amt)
  167. }
  168. #[inline]
  169. fn write_all(&mut self, data: &[u8]) -> io::Result<()> {
  170. if self.write(data)? == data.len() {
  171. Ok(())
  172. } else {
  173. Err(Error::new(ErrorKind::WriteZero, "failed to write whole buffer"))
  174. }
  175. }
  176. #[inline]
  177. fn flush(&mut self) -> io::Result<()> { Ok(()) }
  178. }
  179. #[cfg(feature="collections")]
  180. impl Write for Vec<u8> {
  181. #[inline]
  182. fn write(&mut self, buf: &[u8]) -> io::Result<usize> {
  183. self.extend_from_slice(buf);
  184. Ok(buf.len())
  185. }
  186. #[inline]
  187. fn write_all(&mut self, buf: &[u8]) -> io::Result<()> {
  188. self.extend_from_slice(buf);
  189. Ok(())
  190. }
  191. #[inline]
  192. fn flush(&mut self) -> io::Result<()> { Ok(()) }
  193. }
  194. #[cfg(test)]
  195. mod tests {
  196. use io::prelude::*;
  197. use vec::Vec;
  198. use test;
  199. #[bench]
  200. fn bench_read_slice(b: &mut test::Bencher) {
  201. let buf = [5; 1024];
  202. let mut dst = [0; 128];
  203. b.iter(|| {
  204. let mut rd = &buf[..];
  205. for _ in 0..8 {
  206. let _ = rd.read(&mut dst);
  207. test::black_box(&dst);
  208. }
  209. })
  210. }
  211. #[bench]
  212. fn bench_write_slice(b: &mut test::Bencher) {
  213. let mut buf = [0; 1024];
  214. let src = [5; 128];
  215. b.iter(|| {
  216. let mut wr = &mut buf[..];
  217. for _ in 0..8 {
  218. let _ = wr.write_all(&src);
  219. test::black_box(&wr);
  220. }
  221. })
  222. }
  223. #[bench]
  224. fn bench_read_vec(b: &mut test::Bencher) {
  225. let buf = vec![5; 1024];
  226. let mut dst = [0; 128];
  227. b.iter(|| {
  228. let mut rd = &buf[..];
  229. for _ in 0..8 {
  230. let _ = rd.read(&mut dst);
  231. test::black_box(&dst);
  232. }
  233. })
  234. }
  235. #[bench]
  236. fn bench_write_vec(b: &mut test::Bencher) {
  237. let mut buf = Vec::with_capacity(1024);
  238. let src = [5; 128];
  239. b.iter(|| {
  240. let mut wr = &mut buf[..];
  241. for _ in 0..8 {
  242. let _ = wr.write_all(&src);
  243. test::black_box(&wr);
  244. }
  245. })
  246. }
  247. }