Struct AbxParser 

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

Zero-allocation pull parser that works on an in-memory &[u8].

Advance through the document with next_event or use one of the higher-level helpers.

Implementations

impl<'a> AbxParser<'a>

pub fn new(input: &'a [u8]) -> Result<Self>

Create a parser, validating the 4-byte magic header.

pub fn is_empty(&self) -> bool

true when no more bytes remain.

pub fn next_event(&mut self) -> Result<Option<Event>>

Pull the next Event. Returns None at end of input.

pub fn collect_events(&mut self) -> Result<Vec<Event>>

Drain all remaining events into a Vec.

pub fn find_attribute( &mut self, element: &str, attr: &str, ) -> Result<Option<AttributeValue>>

Return the value of the first matching attr_name inside any <element_name> in the remaining stream. Ok(None) means the element/attribute wasn’t found before the document ended; Err means a parse failure interrupted the search. Callers that don’t care about that distinction can collapse both into None with .ok().flatten().

pub fn find_all_attributes( &mut self, element: &str, attr: &str, ) -> Result<Vec<AttributeValue>>

All values of attr_name found in <element_name> tags.

pub fn attributes_of(&mut self, element: &str) -> Result<Option<Vec<Attribute>>>

Attributes of the first <element_name> tag. Ok(None) means no matching tag was found before the document ended; Err means a parse failure interrupted the search — see find_attribute for how to collapse both into a plain None.

pub fn all_attributes_of( &mut self, element: &str, ) -> Result<Vec<Vec<Attribute>>>

Attributes of every <element_name> tag.

pub fn to_xml(&mut self) -> Result<String>

Render the rest of the document as an XML string.

pub fn write_xml(&mut self, writer: &mut impl Write) -> Result<()>

Write the rest of the document as XML into any std::io::Write sink.

More memory-efficient than to_xml for very large documents because it does not accumulate the whole result in a String.

pub fn deserialize_next<T: DeserializeOwned>( &mut self, element: &str, ) -> Result<Option<T>>

Find the next <element>, deserialize its attributes (and direct text content, via a #[serde(rename = "$text")] field) into T, then skip past its matching end tag. Ok(None) at end of document.

pub fn deserialize_all<T: DeserializeOwned>( &mut self, element: &str, ) -> Result<Vec<T>>

Deserialize every remaining <element> into a Vec<T>.

pub fn into_map(self) -> Result<HashMap<String, Vec<HashMap<String, String>>>>

Collect the whole document into a HashMap<element → Vec<HashMap<attr → value_str>>>.

Trait Implementations

impl<'a> Debug for AbxParser<'a>

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

Formats the value using the given formatter.