Struct QName 

pub struct QName {
    pub prefix: Option<String>,
    pub local: String,
    pub uri: Option<String>,
}

An expanded name: an optional namespace URI plus a local part, with the prefix retained for display.

XPath compares names by namespace URI and local part only; the prefix is carried so that error messages and generated locations can show the name the way the document author wrote it.

Examples

use schematron::xml::QName;

let a = QName::new(Some("inv"), "total", Some("http://example.com/i"));
let b = QName::new(Some("x"), "total", Some("http://example.com/i"));
// Different prefixes, same expanded name.
assert!(a.matches(&b));
assert_eq!(a.display_name(), "inv:total");

Fields

prefix: Option<String>

The prefix as written in the document, if any.

local: String

The local part.

uri: Option<String>

The namespace URI the prefix resolved to, if any.

Implementations

impl QName

pub fn new( prefix: Option<impl Into<String>>, local: impl Into<String>, uri: Option<impl Into<String>>, ) -> Self

Builds a qualified name.

pub fn local(local: impl Into<String>) -> Self

Builds a qualified name in no namespace.

pub fn matches(&self, other: &QName) -> bool

Compares expanded names: namespace URI and local part, ignoring prefix.

pub fn matches_parts(&self, uri: Option<&str>, local: &str) -> bool

Compares against an expanded name given as its parts.

pub fn display_name(&self) -> String

The name as written, prefix:local or local.

This is what the XPath name() function returns.

Trait Implementations

impl Clone for QName

fn clone(&self) -> QName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QName

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

Formats the value using the given formatter.

impl Display for QName

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

Formats the value using the given formatter.

impl Eq for QName

impl Hash for QName

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for QName

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QName