Struct View 

pub struct View<'a> { /* private fields */ }

A bounded window over one address space.

Implementations

impl<'a> View<'a>

pub fn position(self) -> usize

Returns the absolute position within the space.

pub fn start(self) -> usize

Returns the window’s inclusive lower bound.

pub fn end(self) -> usize

Returns the window’s exclusive upper bound.

pub fn remaining(self) -> usize

Returns the number of unread bytes before the window’s end.

pub fn location(self) -> SourceLocation

Returns this view’s current source location.

pub fn window(self) -> &'a [u8]

Returns the readable window start..end as a slice.

pub fn take(&mut self, count: usize) -> Option<&'a [u8]>

Takes count bytes, advancing only on success.

pub fn array<const N: usize>(&mut self) -> Option<[u8; N]>

Takes a fixed-size byte array, advancing only on success.

pub fn skip(&mut self, count: usize) -> Option<()>

Skips exactly count bytes.

pub fn seek(&mut self, position: usize) -> Option<()>

Moves to an absolute offset, honoring the stored lower bound.

pub fn u8(&mut self) -> Option<u8>

Reads a single byte.

pub fn child(self, start: usize, end: usize) -> Option<View<'a>>

Returns an exactly contained child window.

pub fn counted( self, count: u64, min_element_size: usize, ) -> Option<BoundedCount>

Proves a declared element count could fit in the unread bytes.

pub fn req_take(&mut self, count: usize) -> Result<&'a [u8], ParseError>

Required-read mirror of View::take.

pub fn req_u8(&mut self) -> Result<u8, ParseError>

Required-read mirror of View::u8.

impl View<'_>

pub fn u16_le(&mut self) -> Option<u16>

Probe read of a u16 via from_le_bytes.

pub fn req_u16_le(&mut self) -> Result<u16, ParseError>

Required-read mirror of View::u16_le.

pub fn i16_le(&mut self) -> Option<i16>

Probe read of a i16 via from_le_bytes.

pub fn req_i16_le(&mut self) -> Result<i16, ParseError>

Required-read mirror of View::i16_le.

pub fn u32_le(&mut self) -> Option<u32>

Probe read of a u32 via from_le_bytes.

pub fn req_u32_le(&mut self) -> Result<u32, ParseError>

Required-read mirror of View::u32_le.

pub fn i32_le(&mut self) -> Option<i32>

Probe read of a i32 via from_le_bytes.

pub fn req_i32_le(&mut self) -> Result<i32, ParseError>

Required-read mirror of View::i32_le.

pub fn u64_le(&mut self) -> Option<u64>

Probe read of a u64 via from_le_bytes.

pub fn req_u64_le(&mut self) -> Result<u64, ParseError>

Required-read mirror of View::u64_le.

pub fn i64_le(&mut self) -> Option<i64>

Probe read of a i64 via from_le_bytes.

pub fn req_i64_le(&mut self) -> Result<i64, ParseError>

Required-read mirror of View::i64_le.

pub fn f32_le(&mut self) -> Option<f32>

Probe read of a f32 via from_le_bytes.

pub fn req_f32_le(&mut self) -> Result<f32, ParseError>

Required-read mirror of View::f32_le.

pub fn f64_le(&mut self) -> Option<f64>

Probe read of a f64 via from_le_bytes.

pub fn req_f64_le(&mut self) -> Result<f64, ParseError>

Required-read mirror of View::f64_le.

pub fn u16_be(&mut self) -> Option<u16>

Probe read of a u16 via from_be_bytes.

pub fn req_u16_be(&mut self) -> Result<u16, ParseError>

Required-read mirror of View::u16_be.

pub fn u32_be(&mut self) -> Option<u32>

Probe read of a u32 via from_be_bytes.

pub fn req_u32_be(&mut self) -> Result<u32, ParseError>

Required-read mirror of View::u32_be.

pub fn u64_be(&mut self) -> Option<u64>

Probe read of a u64 via from_be_bytes.

pub fn req_u64_be(&mut self) -> Result<u64, ParseError>

Required-read mirror of View::u64_be.

pub fn f64_be(&mut self) -> Option<f64>

Probe read of a f64 via from_be_bytes.

pub fn req_f64_be(&mut self) -> Result<f64, ParseError>

Required-read mirror of View::f64_be.

Trait Implementations

impl<'a> Clone for View<'a>

fn clone(&self) -> View<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for View<'a>

impl<'a> Debug for View<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.