Struct Object

pub struct Object { /* private fields */ }

A RGBDS object file.

Implementations

impl Object

pub fn read_from(input: impl Read) -> Result<Self, Error>

Reads a serialized object.

Errors

This function returns any errors that occurred while reading data, as well as if the object data itself cannot be deserialized. Note that not all consistency checks are performed when reading the file; for example, RPN expressions may be invalid, the file stack node tree may be malformed, etc.

Note that maximum upwards compatibility is assumed: for example, currently, RPN data is parsed using the v9 r8 spec, even if the file reports an earlier revision. This should change in the future.

pub fn version(&self) -> u8

The object’s version.

pub fn revision(&self) -> u32

The object’s revision.

pub fn node(&self, id: u32) -> Option<&Node>

Retrieves one of the object’s file stack nodes by ID. Returns None if the ID is invalid (too large).

pub fn walk_nodes<E, F>( &self, id: u32, callback: &mut F, ) -> Result<(), NodeWalkError<E>>

where F: FnMut(&Node) -> Result<(), NodeWalkError<E>>,

Walks the node tree, from its root up to the node with the given ID, running a callback on each node encountered.

The functon may return an error, which aborts the walk. If the function does not fail, you can (and probably will have to) use Infallible:

object.walk_nodes::<Infallible, _>(0, &mut |node| {
    println!("{node:?}");
    Ok(())
});

pub fn symbols(&self) -> &[Symbol]

The object’s symbols.

pub fn sections(&self) -> &[Section]

The object’s sections.

pub fn assertions(&self) -> &[Assertion]

The object’s assertions.

Trait Implementations

impl Debug for Object

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

Formats the value using the given formatter.