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 fn new() -> Self

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

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

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

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

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

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

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

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

Add a node to the set, maintaining document order and uniqueness.

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.

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.