Struct NodeSet 

pub struct NodeSet { /* private fields */ }

An XPath node-set.

Internally stored as a sorted, deduplicated Vec of node pointers in document order.

Implementations

impl NodeSet

pub const fn new() -> Self

Create an empty node-set.

pub fn singleton(node: *mut _xmlNode) -> Self

Create a node-set containing exactly one node.

pub const fn is_empty(&self) -> bool

Return true if the node-set contains no nodes.

pub const fn len(&self) -> usize

Return the number of nodes in the node-set.

pub fn iter(&self) -> impl Iterator<Item = *mut _xmlNode> + '_

Iterate over the nodes in document order.

pub fn get(&self, index: usize) -> Option<*mut _xmlNode>

Return the node at index in document order, or None if out of bounds.

pub fn first(&self) -> Option<*mut _xmlNode>

Return the first node in document order.

pub fn last(&self) -> Option<*mut _xmlNode>

Return the last node in document order.

pub fn contains(&self, node: *mut _xmlNode) -> bool

Return true if the given node is in the node-set.

pub fn push(&mut self, node: *mut _xmlNode)

Append a node to the set.

This is O(1) and does NOT deduplicate or sort. Callers that need the document-order/unique invariant (axis results are already unique and ordered, but unions and relative-path concatenations are not) call sort once at the boundary. Deferring the sort avoids the O(n² log n) node-set construction cost — the Phase 15.1 XPath perf cliff (count(//item) was ~1000× slower than the oracle because every push re-sorted the growing set).

pub fn extend(&mut self, other: &NodeSet)

Extend with another node-set.

pub fn sort(&mut self)

Sort nodes in document order.

UPSTREAM-PARITY

XPath node-sets are always in document order (XPath 1.0 §3.3). libxml2 maintains this via its node-set insertion/merge logic plus the document-order comparator (xmlXPathNodeSetSort). Sorting by pointer address is NOT document order and breaks downstream ordering guarantees; the oracle-observed symptom is rotated results on the second of two transforms in one process.

pub unsafe fn to_raw(&self) -> *mut _xmlNodeSet

Convert to raw C ABI node-set.

SAFETY: The returned pointer must be freed with xmlXPathFreeNodeSet or the owning XPath object must be freed.

SAFETY

The function touches crate-global state only; it is safe as long as the caller respects the library’s global initialization/cleanup ordering (xmlInitParser before use, xmlCleanupParser only after all users are done).

Violating the global lifecycle ordering, or calling this after teardown or from a signal handler, is undefined behavior.

Trait Implementations

impl Clone for NodeSet

fn clone(&self) -> NodeSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeSet

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

Formats the value using the given formatter.

impl Default for NodeSet

fn default() -> Self

Returns the “default value” for a type.