Struct ParsedFragment 

pub struct ParsedFragment { /* private fields */ }

A parsed markup chunk, bundled with the throwaway document that owns it.

The pairing is the safety property, not a convenience: a libxml Node is a raw pointer into its owning document, so a node that outlives its owner is a dangling FFI pointer — a failure mode this project has already taken SIGSEGVs from, and one that bypasses catch_unwind. Document is refcounted and Clone, so holding this handle keeps ParsedFragment::nodes valid for exactly as long as the handle lives. That is what makes it safe to hand a parsed chunk to an untrusted .rhai script, which controls its own lifetimes.

Implementations

impl ParsedFragment

pub fn nodes(&self) -> Vec<Node>

The top-level parsed nodes, ready to hand to Document::append_tree.

pub fn len(&self) -> usize

How many top-level nodes the chunk parsed to (>1 means it was a fragment).

pub fn is_empty(&self) -> bool

pub fn document(&self) -> &Document

The owning document, for callers that need to keep it alive explicitly.

Trait Implementations

impl Clone for ParsedFragment

fn clone(&self) -> ParsedFragment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedFragment

Hand-written because libxml’s Document/Node are opaque FFI handles whose derived form would print pointers, not markup. Report what a caller actually wants to see: how many top-level nodes, and their names.

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

Formats the value using the given formatter.