Struct xmltree::Element

pub struct Element {
    pub prefix: Option<String>,
    pub namespace: Option<String>,
    pub namespaces: Option<Namespace>,
    pub name: String,
    pub attributes: HashMap<String, String>,
    pub children: Vec<XMLNode>,
}

Represents an XML element.

Fields

prefix: Option<String>

This elements prefix, if any

namespace: Option<String>

This elements namespace, if any

namespaces: Option<Namespace>

The full list of namespaces, if any

The Namespace type is exported from the xml-rs crate.

name: String

The name of the Element. Does not include any namespace info

attributes: HashMap<String, String>

The Element attributes

children: Vec<XMLNode>

Children

Methods

impl Element

pub fn new(name: &str) -> Element

Create a new empty element with given name

All other fields are empty

pub fn parse_all<R: Read>(r: R) -> Result<Vec<XMLNode>, ParseError>

Parses some data into a list of XMLNodes

This is useful when you want to capture comments or processing instructions that appear before or after the root node

pub fn parse<R: Read>(r: R) -> Result<Element, ParseError>

Parses some data into an Element

pub fn write<W: Write>(&self, w: W) -> Result<(), Error>

Writes out this element as the root element in an new XML document

pub fn write_with_config<W: Write>(
    &self,
    w: W,
    config: EmitterConfig
) -> Result<(), Error>

Writes out this element as the root element in a new XML document using the provided configuration

pub fn get_child<P: ElementPredicate>(&self, k: P) -> Option<&Element>

Find a child element with the given name and return a reference to it.

Both &str and String implement ElementPredicate and can be used to search for child elements that match the given element name with .get_child("element_name"). You can also search by ("element_name", "tag_name") tuple.

Note: this will only return Elements. To get other nodes (like comments), iterate through the children field.

pub fn get_mut_child<P: ElementPredicate>(
    &mut self,
    k: P
) -> Option<&mut Element>

Find a child element with the given name and return a mutable reference to it.

pub fn take_child<P: ElementPredicate>(&mut self, k: P) -> Option<Element>

Find a child element with the given name, remove and return it.

pub fn get_text<'a>(&'a self) -> Option<Cow<'a, str>>

Returns the inner text/cdata of this element, if any.

If there are multiple text/cdata nodes, they will be all concatenated into one string.

Trait Implementations

impl Clone for Element

fn clone(&self) -> Element

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Element

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

Formats the value using the given formatter.

impl Eq for Element

impl PartialEq<Element> for Element

fn eq(&self, other: &Element) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Element) -> bool

This method tests for !=.

impl StructuralEq for Element

impl StructuralPartialEq for Element