use std::io::{self, Result}; use ByteOrder; /// Extends `Read` with methods for reading numbers. (For `std::io`.) /// /// Most of the methods defined here have an unconstrained type parameter that /// must be explicitly instantiated. Typically, it is instantiated with either /// the `BigEndian` or `LittleEndian` types defined in this crate. /// /// # Examples /// /// Read unsigned 16 bit big-endian integers from a `Read`: /// /// ```rust /// use std::io::Cursor; /// use byteorder::{BigEndian, ReadBytesExt}; /// /// let mut rdr = Cursor::new(vec![2, 5, 3, 0]); /// assert_eq!(517, rdr.read_u16::().unwrap()); /// assert_eq!(768, rdr.read_u16::().unwrap()); /// ``` pub trait ReadBytesExt: io::Read { /// Reads an unsigned 8 bit integer from the underlying reader. /// /// Note that since this reads a single byte, no byte order conversions /// are used. It is included for completeness. #[inline] fn read_u8(&mut self) -> Result { let mut buf = [0; 1]; try!(self.read_exact(&mut buf)); Ok(buf[0]) } /// Reads a signed 8 bit integer from the underlying reader. /// /// Note that since this reads a single byte, no byte order conversions /// are used. It is included for completeness. #[inline] fn read_i8(&mut self) -> Result { let mut buf = [0; 1]; try!(self.read_exact(&mut buf)); Ok(buf[0] as i8) } /// Reads an unsigned 16 bit integer from the underlying reader. #[inline] fn read_u16(&mut self) -> Result { let mut buf = [0; 2]; try!(self.read_exact(&mut buf)); Ok(T::read_u16(&buf)) } /// Reads a signed 16 bit integer from the underlying reader. #[inline] fn read_i16(&mut self) -> Result { let mut buf = [0; 2]; try!(self.read_exact(&mut buf)); Ok(T::read_i16(&buf)) } /// Reads an unsigned 32 bit integer from the underlying reader. #[inline] fn read_u32(&mut self) -> Result { let mut buf = [0; 4]; try!(self.read_exact(&mut buf)); Ok(T::read_u32(&buf)) } /// Reads a signed 32 bit integer from the underlying reader. #[inline] fn read_i32(&mut self) -> Result { let mut buf = [0; 4]; try!(self.read_exact(&mut buf)); Ok(T::read_i32(&buf)) } /// Reads an unsigned 64 bit integer from the underlying reader. #[inline] fn read_u64(&mut self) -> Result { let mut buf = [0; 8]; try!(self.read_exact(&mut buf)); Ok(T::read_u64(&buf)) } /// Reads a signed 64 bit integer from the underlying reader. #[inline] fn read_i64(&mut self) -> Result { let mut buf = [0; 8]; try!(self.read_exact(&mut buf)); Ok(T::read_i64(&buf)) } /// Reads an unsigned n-bytes integer from the underlying reader. #[inline] fn read_uint(&mut self, nbytes: usize) -> Result { let mut buf = [0; 8]; try!(self.read_exact(&mut buf[..nbytes])); Ok(T::read_uint(&buf[..nbytes], nbytes)) } /// Reads a signed n-bytes integer from the underlying reader. #[inline] fn read_int(&mut self, nbytes: usize) -> Result { let mut buf = [0; 8]; try!(self.read_exact(&mut buf[..nbytes])); Ok(T::read_int(&buf[..nbytes], nbytes)) } /// Reads a IEEE754 single-precision (4 bytes) floating point number from /// the underlying reader. #[inline] fn read_f32(&mut self) -> Result { let mut buf = [0; 4]; try!(self.read_exact(&mut buf)); Ok(T::read_f32(&buf)) } /// Reads a IEEE754 double-precision (8 bytes) floating point number from /// the underlying reader. #[inline] fn read_f64(&mut self) -> Result { let mut buf = [0; 8]; try!(self.read_exact(&mut buf)); Ok(T::read_f64(&buf)) } } /// All types that implement `Read` get methods defined in `ReadBytesExt` /// for free. impl ReadBytesExt for R {} /// Extends `Write` with methods for writing numbers. (For `std::io`.) /// /// Most of the methods defined here have an unconstrained type parameter that /// must be explicitly instantiated. Typically, it is instantiated with either /// the `BigEndian` or `LittleEndian` types defined in this crate. /// /// # Examples /// /// Write unsigned 16 bit big-endian integers to a `Write`: /// /// ```rust /// use byteorder::{BigEndian, WriteBytesExt}; /// /// let mut wtr = vec![]; /// wtr.write_u16::(517).unwrap(); /// wtr.write_u16::(768).unwrap(); /// assert_eq!(wtr, vec![2, 5, 3, 0]); /// ``` pub trait WriteBytesExt: io::Write { /// Writes an unsigned 8 bit integer to the underlying writer. /// /// Note that since this writes a single byte, no byte order conversions /// are used. It is included for completeness. #[inline] fn write_u8(&mut self, n: u8) -> Result<()> { self.write_all(&[n]) } /// Writes a signed 8 bit integer to the underlying writer. /// /// Note that since this writes a single byte, no byte order conversions /// are used. It is included for completeness. #[inline] fn write_i8(&mut self, n: i8) -> Result<()> { self.write_all(&[n as u8]) } /// Writes an unsigned 16 bit integer to the underlying writer. #[inline] fn write_u16(&mut self, n: u16) -> Result<()> { let mut buf = [0; 2]; T::write_u16(&mut buf, n); self.write_all(&buf) } /// Writes a signed 16 bit integer to the underlying writer. #[inline] fn write_i16(&mut self, n: i16) -> Result<()> { let mut buf = [0; 2]; T::write_i16(&mut buf, n); self.write_all(&buf) } /// Writes an unsigned 32 bit integer to the underlying writer. #[inline] fn write_u32(&mut self, n: u32) -> Result<()> { let mut buf = [0; 4]; T::write_u32(&mut buf, n); self.write_all(&buf) } /// Writes a signed 32 bit integer to the underlying writer. #[inline] fn write_i32(&mut self, n: i32) -> Result<()> { let mut buf = [0; 4]; T::write_i32(&mut buf, n); self.write_all(&buf) } /// Writes an unsigned 64 bit integer to the underlying writer. #[inline] fn write_u64(&mut self, n: u64) -> Result<()> { let mut buf = [0; 8]; T::write_u64(&mut buf, n); self.write_all(&buf) } /// Writes a signed 64 bit integer to the underlying writer. #[inline] fn write_i64(&mut self, n: i64) -> Result<()> { let mut buf = [0; 8]; T::write_i64(&mut buf, n); self.write_all(&buf) } /// Writes an unsigned n-bytes integer to the underlying writer. /// /// If the given integer is not representable in the given number of bytes, /// this method panics. If `nbytes > 8`, this method panics. #[inline] fn write_uint( &mut self, n: u64, nbytes: usize, ) -> Result<()> { let mut buf = [0; 8]; T::write_uint(&mut buf, n, nbytes); self.write_all(&buf[0..nbytes]) } /// Writes a signed n-bytes integer to the underlying writer. /// /// If the given integer is not representable in the given number of bytes, /// this method panics. If `nbytes > 8`, this method panics. #[inline] fn write_int( &mut self, n: i64, nbytes: usize, ) -> Result<()> { let mut buf = [0; 8]; T::write_int(&mut buf, n, nbytes); self.write_all(&buf[0..nbytes]) } /// Writes a IEEE754 single-precision (4 bytes) floating point number to /// the underlying writer. #[inline] fn write_f32(&mut self, n: f32) -> Result<()> { let mut buf = [0; 4]; T::write_f32(&mut buf, n); self.write_all(&buf) } /// Writes a IEEE754 double-precision (8 bytes) floating point number to /// the underlying writer. #[inline] fn write_f64(&mut self, n: f64) -> Result<()> { let mut buf = [0; 8]; T::write_f64(&mut buf, n); self.write_all(&buf) } } /// All types that implement `Write` get methods defined in `WriteBytesExt` /// for free. impl WriteBytesExt for W {}