Struct elementtree::QName

pub struct QName<'a> { /* fields omitted */ }

A QName represents a qualified name.

A qualified name is a tag or attribute name that has a namespace and a local name. If the namespace is empty no namespace is assumed. It can be constructed from a qualified name string with the from method.

Notes on Memory Management

Qualified names that are user constructed for comparison purposes usually have a static lifetime because they are created from static strings. Creating qualified names from other strings might make memory management harder which is why share() exists which moves the QName internal strings to shared storage in which the lifetime changes to 'static.

Common usage examples:

let href = QName::from_name("href");
let a = QName::from("{http://www.w3.org/1999/xhtml}a");

Methods

impl<'a> QName<'a>

fn from(s: &'a str) -> QName<'a>

Creates a qualified name from a given string.

Two formats are supported {namespace}tag or just tag.

let a = QName::from("{http://www.w3.org/1999/xhtml}a");

fn from_name(name: &'a str) -> QName<'a>

Creates a qualified name from a given string without namespace.

This is slightly faster than using from().

fn from_ns_name(ns: Option<&'a str>, name: &'a str) -> QName<'a>

Creates a qualified name from a namespace and name.

fn name(&self) -> &str

Returns the name portion of the qualified name. This is the local tag or attribute name.

fn ns(&self) -> Option<&str>

Returns the optional namespace of this element. This is the URL of the namespace and not the prefix. The information about the latter is not retained.

fn share(&self) -> QName<'static>

Creates a shared QName with static lifetime from an already existing QName. The internal strings are interned and might be shared with other instances.

Trait Implementations

impl<'a> AsQName<'a> for &'a QName<'a>

fn as_qname(&self) -> Cow<'a, QName<'a>>

Returns a Cow'ed QName from the given object.

impl<'a> Clone for QName<'a>

fn clone(&self) -> QName<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> PartialEq for QName<'a>

fn eq(&self, other: &QName<'a>) -> bool

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

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

This method tests for !=.

impl<'a> Debug for QName<'a>

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

Formats the value using the given formatter.

impl<'a> Display for QName<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for QName<'a>

impl<'a> Hash for QName<'a>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<'a> PartialOrd for QName<'a>

fn partial_cmp(&self, other: &QName<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> Ord for QName<'a>

fn cmp(&self, other: &QName<'a>) -> Ordering

This method returns an Ordering between self and other.