Struct TableRef 

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

A view over one table’s fixed part. Never panics on malformed input.

Implementations

impl<'a> TableRef<'a>

pub fn at(buf: &'a [u8], pos: usize) -> Result<Self, Error>

Table with a [u16 fixed_len] header at pos.

pub fn inline( buf: &'a [u8], fixed_start: usize, fixed_len: u16, ) -> Result<Self, Error>

Header-less table (list element) whose fixed part starts at fixed_start.

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

pub fn fixed_len(&self) -> u16

pub fn fixed_start(&self) -> usize

Absolute position of the fixed part’s first byte.

pub fn fixed_byte(&self, i: u16) -> u8

One byte of the fixed part; outside fixed_len ⇒ 0.

pub fn bit(&self, b: Bit) -> bool

Bit value; a bit byte outside fixed_len reads as false (absent).

pub fn slot_state(&self, off: u16, size: u16) -> Result<bool, Error>

Ok(true) if the slot is fully inside fixed_len, Ok(false) if fully outside, Err(Truncated) if partially covered.

pub fn scalar<T: Le>(&self, off: u16, presence: Bit) -> Result<Option<T>, Error>

Scalar with presence bit, following the field read rule.

pub fn scalar_or<T: Le>(&self, off: u16, presence: Bit, default: T) -> T

Scalar for an already-validated required field; any anomaly yields default.

pub fn raw<T: Le>(&self, off: u16) -> T

Slot value ignoring presence, for required fields already validated by the generated read(). Slot not fully inside fixed_len ⇒ T::default().

pub fn bool(&self, presence: Bit) -> Option<bool>

Bool stored as presence bit + value bit (shift + 1).

impl<'a> TableRef<'a>

pub fn ptr(&self, off: u16) -> Result<Option<usize>, Error>

Absolute target of the pointer at slot off. Slot outside fixed_len or 0 ⇒ None.

pub fn bytes(&self, off: u16) -> Result<Option<&'a [u8]>, Error>

pub fn str(&self, off: u16) -> Result<Option<&'a str>, Error>

pub fn table(&self, off: u16) -> Result<Option<TableRef<'a>>, Error>

pub fn union(&self, off: u16) -> Result<Option<(u16, TableRef<'a>)>, Error>

Union slot [u16 tag][i32 ptr]; tag 0 ⇒ None.

pub fn scalars<T: Le>( &self, off: u16, ) -> Result<Option<ScalarList<'a, T>>, Error>

pub fn tables(&self, off: u16) -> Result<Option<TableList<'a>>, Error>

pub fn strs(&self, off: u16) -> Result<Option<StrList<'a>>, Error>

Trait Implementations

impl<'a> Clone for TableRef<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for TableRef<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for TableRef<'a>