use super::{read_marker, RmpRead, ValueReadError}; use crate::Marker; /// Attempts to read a single byte from the given reader and to decode it as a positive fixnum /// value. /// /// According to the MessagePack specification, a positive fixed integer value is represented using /// a single byte in `[0x00; 0x7f]` range inclusively, prepended with a special marker mask. /// /// # Errors /// /// This function will return `ValueReadError` on any I/O error while reading the marker, /// except the EINTR, which is handled internally. /// /// It also returns `ValueReadError::TypeMismatch` if the actual type is not equal with the /// expected one, indicating you with the actual type. /// /// # Note /// /// This function will silently retry on every EINTR received from the underlying `Read` until /// successful read. pub fn read_pfix(rd: &mut R) -> Result> { match read_marker(rd)? { Marker::FixPos(val) => Ok(val), marker => Err(ValueReadError::TypeMismatch(marker)), } } /// Attempts to read exactly 2 bytes from the given reader and to decode them as `u8` value. /// /// The first byte should be the marker and the second one should represent the data itself. /// /// # Errors /// /// This function will return `ValueReadError` on any I/O error while reading either the marker or /// the data. /// /// It also returns `ValueReadError::TypeMismatch` if the actual type is not equal with the /// expected one, indicating you with the actual type. pub fn read_u8(rd: &mut R) -> Result> { match read_marker(rd)? { Marker::U8 => rd.read_data_u8(), marker => Err(ValueReadError::TypeMismatch(marker)), } } /// Attempts to read exactly 3 bytes from the given reader and to decode them as `u16` value. /// /// The first byte should be the marker and the others should represent the data itself. /// /// # Errors /// /// This function will return `ValueReadError` on any I/O error while reading either the marker or /// the data. /// /// It also returns `ValueReadError::TypeMismatch` if the actual type is not equal with the /// expected one, indicating you with the actual type. /// /// # Note /// /// This function will silently retry on every EINTR received from the underlying `Read` until /// successful read. pub fn read_u16(rd: &mut R) -> Result> { match read_marker(rd)? { Marker::U16 => rd.read_data_u16(), marker => Err(ValueReadError::TypeMismatch(marker)), } } /// Attempts to read exactly 5 bytes from the given reader and to decode them as `u32` value. /// /// The first byte should be the marker and the others should represent the data itself. /// /// # Errors /// /// This function will return `ValueReadError` on any I/O error while reading either the marker or /// the data. /// /// It also returns `ValueReadError::TypeMismatch` if the actual type is not equal with the /// expected one, indicating you with the actual type. /// /// # Note /// /// This function will silently retry on every EINTR received from the underlying `Read` until /// successful read. pub fn read_u32(rd: &mut R) -> Result> { match read_marker(rd)? { Marker::U32 => rd.read_data_u32(), marker => Err(ValueReadError::TypeMismatch(marker)), } } /// Attempts to read exactly 9 bytes from the given reader and to decode them as `u64` value. /// /// The first byte should be the marker and the others should represent the data itself. /// /// # Errors /// /// This function will return `ValueReadError` on any I/O error while reading either the marker or /// the data. /// /// It also returns `ValueReadError::TypeMismatch` if the actual type is not equal with the /// expected one, indicating you with the actual type. /// /// # Note /// /// This function will silently retry on every EINTR received from the underlying `Read` until /// successful read. pub fn read_u64(rd: &mut R) -> Result> { match read_marker(rd)? { Marker::U64 => rd.read_data_u64(), marker => Err(ValueReadError::TypeMismatch(marker)), } }