Trait byteorder::WriteBytesExt
[−]
[src]
pub trait WriteBytesExt: Write { fn write_u8(&mut self, n: u8) -> Result<()> { ... } fn write_i8(&mut self, n: i8) -> Result<()> { ... } fn write_u16<T: ByteOrder>(&mut self, n: u16) -> Result<()> { ... } fn write_i16<T: ByteOrder>(&mut self, n: i16) -> Result<()> { ... } fn write_u24<T: ByteOrder>(&mut self, n: u32) -> Result<()> { ... } fn write_i24<T: ByteOrder>(&mut self, n: i32) -> Result<()> { ... } fn write_u32<T: ByteOrder>(&mut self, n: u32) -> Result<()> { ... } fn write_i32<T: ByteOrder>(&mut self, n: i32) -> Result<()> { ... } fn write_u64<T: ByteOrder>(&mut self, n: u64) -> Result<()> { ... } fn write_i64<T: ByteOrder>(&mut self, n: i64) -> Result<()> { ... } fn write_uint<T: ByteOrder>(&mut self, n: u64, nbytes: usize) -> Result<()> { ... } fn write_int<T: ByteOrder>(&mut self, n: i64, nbytes: usize) -> Result<()> { ... } fn write_f32<T: ByteOrder>(&mut self, n: f32) -> Result<()> { ... } fn write_f64<T: ByteOrder>(&mut self, n: f64) -> Result<()> { ... } }
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
:
use byteorder::{BigEndian, WriteBytesExt}; let mut wtr = vec![]; wtr.write_u16::<BigEndian>(517).unwrap(); wtr.write_u16::<BigEndian>(768).unwrap(); assert_eq!(wtr, vec![2, 5, 3, 0]);
Provided Methods
fn write_u8(&mut self, n: u8) -> Result<()>
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.
Errors
This method returns the same errors as Write::write_all
.
fn write_i8(&mut self, n: i8) -> Result<()>
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.
Errors
This method returns the same errors as Write::write_all
.
fn write_u16<T: ByteOrder>(&mut self, n: u16) -> Result<()>
Writes an unsigned 16 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_i16<T: ByteOrder>(&mut self, n: i16) -> Result<()>
Writes a signed 16 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_u24<T: ByteOrder>(&mut self, n: u32) -> Result<()>
Writes an unsigned 24 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_i24<T: ByteOrder>(&mut self, n: i32) -> Result<()>
Writes a signed 24 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_u32<T: ByteOrder>(&mut self, n: u32) -> Result<()>
Writes an unsigned 32 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_i32<T: ByteOrder>(&mut self, n: i32) -> Result<()>
Writes a signed 32 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_u64<T: ByteOrder>(&mut self, n: u64) -> Result<()>
Writes an unsigned 64 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_i64<T: ByteOrder>(&mut self, n: i64) -> Result<()>
Writes a signed 64 bit integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_uint<T: ByteOrder>(&mut self, n: u64, nbytes: usize) -> Result<()>
Writes an unsigned n-bytes integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
Panics
If the given integer is not representable in the given number of bytes,
this method panics. If nbytes > 8
, this method panics.
fn write_int<T: ByteOrder>(&mut self, n: i64, nbytes: usize) -> Result<()>
Writes a signed n-bytes integer to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
Panics
If the given integer is not representable in the given number of bytes,
this method panics. If nbytes > 8
, this method panics.
fn write_f32<T: ByteOrder>(&mut self, n: f32) -> Result<()>
Writes a IEEE754 single-precision (4 bytes) floating point number to the underlying writer.
Errors
This method returns the same errors as Write::write_all
.
fn write_f64<T: ByteOrder>(&mut self, n: f64) -> Result<()>
Writes a IEEE754 double-precision (8 bytes) floating point number to the underlying writer.