Struct Arena

Source

pub struct Arena { /* private fields */ }

Expand description

Arena-based storage for all DOM nodes, text content, and attributes.

Nodes are stored in a contiguous Vec<Node> for cache-line-friendly access. Text and attributes are stored in separate slabs and referenced by offset+length from each node.

Implementations§

Source §

impl Arena

Source

pub fn new() -> Self

Create a new empty arena.

Source

pub fn with_capacity(node_cap: usize, text_cap: usize, attr_cap: usize) -> Self

Create a new arena with pre-allocated capacity.

Source

pub fn enable_tag_index(&mut self)

Enable the inline tag index.

Once enabled, every Arena::new_element call appends the node id to the corresponding tag bucket. Consumers can retrieve the index via Arena::tag_index.

Source

pub fn tag_index(&self) -> Option<&[Vec<NodeId>; 256]>

Get the pre-built tag index, if it was enabled during construction.

Source

pub fn new_element(&mut self, tag: Tag, depth: u16) -> NodeId

Allocate a new element node and return its id.

Source

pub fn set_unknown_tag_name(&mut self, node: NodeId, tag_name: &str)

Store the original tag name for an unknown/custom element.

Source

pub fn new_text(&mut self, depth: u16, text: &str) -> NodeId

Allocate a new text node, storing content in the text slab.

Source

pub fn new_text_ref( &mut self, depth: u16, source_offset: u32, len: u32, ) -> NodeId

Allocate a text node that references a region of the original source.

Instead of copying content to the text slab, this stores a (source_offset, len) pair and sets NodeFlags::IS_TEXT_FROM_SOURCE. The source must have been set via Arena::set_source before calling this method.

Source

pub fn set_source(&mut self, input: &str)

Store an owned copy of the input source for source-backed text nodes.

Source

pub fn set_source_owned(&mut self, source: String)

Transfer an already-owned String as the source buffer (zero copy).

When the caller owns the input String (e.g., from an HTTP response), this avoids the memcpy that set_source performs.

Source

pub fn new_comment(&mut self, depth: u16, text: &str) -> NodeId

Allocate a new comment node, storing content in the text slab.

Source

pub fn new_doctype(&mut self, depth: u16, text: &str) -> NodeId

Allocate a new doctype node, storing content in the text slab.

Source

pub fn set_attrs(&mut self, node: NodeId, attrs: &[Attribute<'_>])

Set attributes for a node from tokenizer attributes.

Source

pub fn set_attrs_from_raw(&mut self, node: NodeId, attr_raw: &str)

Parse attributes directly from a raw attribute region into the slab.

Skips all intermediate Vec<Attribute> allocation — names and values are written directly to attr_str_slab and compact Attribute structs are pushed to attr_slab in a single pass.

Source

pub fn set_element_index(&mut self, node: NodeId, index: u16)

Set the 1-based element sibling index for a node.

Called by TreeBuilder after appending an element child.

Source

pub fn set_self_closing(&mut self, node: NodeId)

Set the self-closing flag on a node.

Source

pub fn append_child(&mut self, parent: NodeId, child: NodeId)

Append child as the last child of parent.

Updates all tree links: parent, first_child, last_child, prev_sibling, next_sibling. Uses unchecked indexing since NodeIds are always valid indices created by this arena.

child must be a freshly allocated, not-yet-linked node, distinct from parent (and therefore from parent’s current last child). Internal callers always satisfy this; the debug assertions below catch misuse.

Source