Struct xmpp_parsers::Element

source ·

pub struct Element {
    pub prefixes: Prefixes,
    /* private fields */
}

Expand description

A struct representing a DOM Element.

Fields§

§prefixes: Prefixes

Namespace declarations

Implementations§

source §

impl Element

source

pub fn builder<S, NS>(name: S, namespace: NS) -> ElementBuilderwhere S: AsRef<str>, NS: Into<String>,

Return a builder for an Element with the given name.

Examples

use minidom::Element;

let elem = Element::builder("name", "namespace")
                   .attr("name", "value")
                   .append("inner")
                   .build();

assert_eq!(elem.name(), "name");
assert_eq!(elem.ns(), "namespace".to_owned());
assert_eq!(elem.attr("name"), Some("value"));
assert_eq!(elem.attr("inexistent"), None);
assert_eq!(elem.text(), "inner");

source

pub fn bare<S, NS>(name: S, namespace: NS) -> Elementwhere S: Into<String>, NS: Into<String>,

Returns a bare minimum Element with this name.

Examples

use minidom::Element;

let bare = Element::bare("name", "namespace");

assert_eq!(bare.name(), "name");
assert_eq!(bare.ns(), "namespace");
assert_eq!(bare.attr("name"), None);
assert_eq!(bare.text(), "");

source

pub fn name(&self) -> &str

Returns a reference to the local name of this element (that is, without a possible prefix).

source

pub fn ns(&self) -> String

Returns a reference to the namespace of this element.

source

pub fn attr(&self, name: &str) -> Option<&str>

Returns a reference to the value of the given attribute, if it exists, else None.

source

pub fn attrs(&self) -> Attrs<'_>

Returns an iterator over the attributes of this element.

Example

use minidom::Element;

let elm: Element = "<elem xmlns=\"ns1\" a=\"b\" />".parse().unwrap();

let mut iter = elm.attrs();

assert_eq!(iter.next().unwrap(), ("a", "b"));
assert_eq!(iter.next(), None);

source

pub fn attrs_mut(&mut self) -> AttrsMut<'_>

Returns an iterator over the attributes of this element, with the value being a mutable reference.

Like write_to() but without the <?xml?> prelude

source

pub fn nodes(&self) -> Iter<'_, Node>

Returns an iterator over references to every child node of this element.

Examples

use minidom::Element;

let elem: Element = "<root xmlns=\"ns1\">a<c1 />b<c2 />c</root>".parse().unwrap();

let mut iter = elem.nodes();

assert_eq!(iter.next().unwrap().as_text().unwrap(), "a");
assert_eq!(iter.next().unwrap().as_element().unwrap().name(), "c1");
assert_eq!(iter.next().unwrap().as_text().unwrap(), "b");
assert_eq!(iter.next().unwrap().as_element().unwrap().name(), "c2");
assert_eq!(iter.next().unwrap().as_text().unwrap(), "c");
assert_eq!(iter.next(), None);

source

pub fn nodes_mut(&mut self) -> IterMut<'_, Node>

Returns an iterator over mutable references to every child node of this element.

source

pub fn children(&self) -> Children<'_>

Returns an iterator over references to every child element of this element.

Examples

use minidom::Element;

let elem: Element = "<root xmlns=\"ns1\">hello<child1 xmlns=\"ns1\"/>this<child2 xmlns=\"ns1\"/>is<child3 xmlns=\"ns1\"/>ignored</root>".parse().unwrap();

let mut iter = elem.children();
assert_eq!(iter.next().unwrap().name(), "child1");
assert_eq!(iter.next().unwrap().name(), "child2");
assert_eq!(iter.next().unwrap().name(), "child3");
assert_eq!(iter.next(), None);

source

pub fn children_mut(&mut self) -> ChildrenMut<'_>

Returns an iterator over mutable references to every child element of this element.

source

pub fn texts(&self) -> Texts<'_>

Returns an iterator over references to every text node of this element.

Examples

use minidom::Element;

let elem: Element = "<root xmlns=\"ns1\">hello<c /> world!</root>".parse().unwrap();

let mut iter = elem.texts();
assert_eq!(iter.next().unwrap(), "hello");
assert_eq!(iter.next().unwrap(), " world!");
assert_eq!(iter.next(), None);