pub struct Object<'a, 's, D, G> { /* private fields */ }Expand description
A stable view into its owning reading. Node handles cannot be constructed publicly, moved between owners or used after their owning storage drops.
Implementations§
Source§impl<'a, 's, D: Copy + Eq, G: Copy + Eq> Object<'a, 's, D, G>
impl<'a, 's, D: Copy + Eq, G: Copy + Eq> Object<'a, 's, D, G>
Sourcepub fn location(self) -> Location
pub fn location(self) -> Location
Original range and coordinate domain; never a re-encoded value.
Sourcepub fn boolean(self) -> Option<bool>
pub fn boolean(self) -> Option<bool>
Original boolean scalar. This O(1) metadata getter does not traverse source data or decide whether the enclosing schema accepts a boolean.
Sourcepub fn string_body(self) -> Option<(Form, Location)>
pub fn string_body(self) -> Option<(Form, Location)>
Exact original encoded string body and spelling. Decoding is a separate paid source query; this getter never materializes a potentially large value or mistakes literal/hex delimiters for signature content octets.
§Panics
Panics if a parsed string’s internally retained delimiters are invalid.
Sourcepub fn reference(self) -> Option<(u64, u16)>
pub fn reference(self) -> Option<(u64, u16)>
Original indirect identity, without resolution, implicit I/O or fallback to a different generation’s object.
Sourcepub fn unsigned(self, operation: &impl Work) -> Result<u64>
pub fn unsigned(self, operation: &impl Work) -> Result<u64>
Queries an integer as a nonnegative u64 under current/original work. A wider valid integer is explicitly unsupported for THIS query; it is not saturated, clamped or relabelled malformed during object reading.
Sourcepub fn name_equals(self, expected: &[u8], operation: &impl Work) -> Result<bool>
pub fn name_equals(self, expected: &[u8], operation: &impl Work) -> Result<bool>
Compares a decoded PDF name with caller bytes, paying before traversal. PDF names have byte identity, without case/Unicode normalization.
Sourcepub fn get(self, key: &[u8], operation: &impl Work) -> Result<Option<Self>>
pub fn get(self, key: &[u8], operation: &impl Work) -> Result<Option<Self>>
Queries a dictionary by its decoded byte-name through the paid index. Null entries are absent; an equal repeated value retains its FIRST original encoding and a separate format fault. Conflicts never reach this getter. This lookup does not resolve indirect references.
Sourcepub fn members<'q>(
self,
operation: &'q impl Work,
) -> Option<Members<'a, 's, 'q, D, G>>where
's: 'q,
pub fn members<'q>(
self,
operation: &'q impl Work,
) -> Option<Members<'a, 's, 'q, D, G>>where
's: 'q,
Original direct member traversal. Dictionaries expose alternating key and value nodes in wire order, arrays expose their ordered elements. Constructor is allocation-free; each step pays before accessing a link. After its first resource error the iterator is fused.