impls.rs 7.7 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. use boxed::Box;
  11. use cmp;
  12. use io::{self, SeekFrom, Read, Write, Seek, BufRead, Error, ErrorKind};
  13. use fmt;
  14. use mem;
  15. use string::String;
  16. use vec::Vec;
  17. // =============================================================================
  18. // Forwarding implementations
  19. #[stable(feature = "rust1", since = "1.0.0")]
  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. #[inline]
  26. fn read_to_end(&mut self, buf: &mut Vec<u8>) -> io::Result<usize> {
  27. (**self).read_to_end(buf)
  28. }
  29. #[inline]
  30. fn read_to_string(&mut self, buf: &mut String) -> io::Result<usize> {
  31. (**self).read_to_string(buf)
  32. }
  33. #[inline]
  34. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  35. (**self).read_exact(buf)
  36. }
  37. }
  38. #[stable(feature = "rust1", since = "1.0.0")]
  39. impl<'a, W: Write + ?Sized> Write for &'a mut W {
  40. #[inline]
  41. fn write(&mut self, buf: &[u8]) -> io::Result<usize> { (**self).write(buf) }
  42. #[inline]
  43. fn flush(&mut self) -> io::Result<()> { (**self).flush() }
  44. #[inline]
  45. fn write_all(&mut self, buf: &[u8]) -> io::Result<()> {
  46. (**self).write_all(buf)
  47. }
  48. #[inline]
  49. fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> {
  50. (**self).write_fmt(fmt)
  51. }
  52. }
  53. #[stable(feature = "rust1", since = "1.0.0")]
  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. #[stable(feature = "rust1", since = "1.0.0")]
  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. #[stable(feature = "rust1", since = "1.0.0")]
  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. #[inline]
  80. fn read_to_end(&mut self, buf: &mut Vec<u8>) -> io::Result<usize> {
  81. (**self).read_to_end(buf)
  82. }
  83. #[inline]
  84. fn read_to_string(&mut self, buf: &mut String) -> io::Result<usize> {
  85. (**self).read_to_string(buf)
  86. }
  87. #[inline]
  88. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  89. (**self).read_exact(buf)
  90. }
  91. }
  92. #[stable(feature = "rust1", since = "1.0.0")]
  93. impl<W: Write + ?Sized> Write for Box<W> {
  94. #[inline]
  95. fn write(&mut self, buf: &[u8]) -> io::Result<usize> { (**self).write(buf) }
  96. #[inline]
  97. fn flush(&mut self) -> io::Result<()> { (**self).flush() }
  98. #[inline]
  99. fn write_all(&mut self, buf: &[u8]) -> io::Result<()> {
  100. (**self).write_all(buf)
  101. }
  102. #[inline]
  103. fn write_fmt(&mut self, fmt: fmt::Arguments) -> io::Result<()> {
  104. (**self).write_fmt(fmt)
  105. }
  106. }
  107. #[stable(feature = "rust1", since = "1.0.0")]
  108. impl<S: Seek + ?Sized> Seek for Box<S> {
  109. #[inline]
  110. fn seek(&mut self, pos: SeekFrom) -> io::Result<u64> { (**self).seek(pos) }
  111. }
  112. #[stable(feature = "rust1", since = "1.0.0")]
  113. impl<B: BufRead + ?Sized> BufRead for Box<B> {
  114. #[inline]
  115. fn fill_buf(&mut self) -> io::Result<&[u8]> { (**self).fill_buf() }
  116. #[inline]
  117. fn consume(&mut self, amt: usize) { (**self).consume(amt) }
  118. #[inline]
  119. fn read_until(&mut self, byte: u8, buf: &mut Vec<u8>) -> io::Result<usize> {
  120. (**self).read_until(byte, buf)
  121. }
  122. #[inline]
  123. fn read_line(&mut self, buf: &mut String) -> io::Result<usize> {
  124. (**self).read_line(buf)
  125. }
  126. }
  127. // =============================================================================
  128. // In-memory buffer implementations
  129. #[stable(feature = "rust1", since = "1.0.0")]
  130. impl<'a> Read for &'a [u8] {
  131. #[inline]
  132. fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
  133. let amt = cmp::min(buf.len(), self.len());
  134. let (a, b) = self.split_at(amt);
  135. buf[..amt].copy_from_slice(a);
  136. *self = b;
  137. Ok(amt)
  138. }
  139. #[inline]
  140. fn read_exact(&mut self, buf: &mut [u8]) -> io::Result<()> {
  141. if buf.len() > self.len() {
  142. return Err(Error::new(ErrorKind::UnexpectedEof,
  143. "failed to fill whole buffer"));
  144. }
  145. let (a, b) = self.split_at(buf.len());
  146. buf.copy_from_slice(a);
  147. *self = b;
  148. Ok(())
  149. }
  150. }
  151. #[stable(feature = "rust1", since = "1.0.0")]
  152. impl<'a> BufRead for &'a [u8] {
  153. #[inline]
  154. fn fill_buf(&mut self) -> io::Result<&[u8]> { Ok(*self) }
  155. #[inline]
  156. fn consume(&mut self, amt: usize) { *self = &self[amt..]; }
  157. }
  158. #[stable(feature = "rust1", since = "1.0.0")]
  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. #[stable(feature = "rust1", since = "1.0.0")]
  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. }