Struct xml_string::names::ParsedUriQualifiedName

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

Parsed URIQualifiedName reference.

Implementations

impl<'a> ParsedUriQualifiedName<'a>

pub fn from_str(s: &'a str) -> Result<Self, NameError>

Creates a new ParsedUriQualifiedName<'_> from the given string slice.

Failures

Fails if the given string is not a valid URIQualifiedName.

Examples

let name = ParsedUriQualifiedName::from_str("Q{http://example.com/}name")?;
assert_eq!(name, "Q{http://example.com/}name");

assert_eq!(
    ParsedUriQualifiedName::from_str("Q{}name")?,
    "Q{}name",
    "Empty URI is OK"
);
assert_eq!(
    ParsedUriQualifiedName::from_str("Q{foo}bar")?,
    "Q{foo}bar",
    "URI is not validated"
);

assert!(
    ParsedUriQualifiedName::from_str("foo").is_err(),
    "URIQualifiedName has `Q{{uri}}ncname` format"
);
assert!(
    ParsedUriQualifiedName::from_str("Q{http://example.com}foo:bar").is_err(),
    "Colon is not allowed"
);
assert!(
    ParsedUriQualifiedName::from_str("Q{foo{bar}qux").is_err(),
    "URI part cannot have `{{` and `}}`"
);

#[must_use]pub fn as_uri_qualified_name(&self) -> &'a UriQualifiedName

Returns the string as &UriQualifiedName.

Exmaples

use xml_string::names::UriQualifiedName;

let name = ParsedUriQualifiedName::from_str("Q{foo}bar")?;
assert_eq!(name, "Q{foo}bar");

let s: &UriQualifiedName = name.as_uri_qualified_name();
assert_eq!(s, "Q{foo}bar");

#[must_use]pub fn as_str(&self) -> &'a str

Returns the string as &str.

Exmaples

let name = ParsedUriQualifiedName::from_str("Q{foo}bar")?;
assert_eq!(name, "Q{foo}bar");

let s: &str = name.as_str();
assert_eq!(s, "Q{foo}bar");

#[must_use]pub fn uri(&self) -> &'a str

Returns the URI.

Examples

let name = ParsedUriQualifiedName::from_str("Q{foo}bar")?;
assert_eq!(name.uri(), "foo");

let empty_uri = ParsedUriQualifiedName::from_str("Q{}foo")?;
assert_eq!(empty_uri.uri(), "");

#[must_use]pub fn local_name(&self) -> &'a Ncname

Returns the local name.

Examples

let name = ParsedUriQualifiedName::from_str("Q{foo}bar")?;
assert_eq!(name.local_name(), "bar");

#[must_use]pub fn uri_and_local(&self) -> (&'a str, &'a Ncname)

Returns a pair of the URI and the local name.

This is efficient version of (self.uri(), self.local_name()).

Examples

use std::convert::TryFrom;

let name = ParsedUriQualifiedName::from_str("Q{foo}bar")?;
assert_eq!(name.uri_and_local(), (name.uri(), name.local_name()));

Trait Implementations

impl<'_> AsRef<UriQualifiedName> for ParsedUriQualifiedName<'_>

pub fn as_ref(&self) -> &UriQualifiedName

Performs the conversion.

impl<'_> AsRef<str> for ParsedUriQualifiedName<'_>

pub fn as_ref(&self) -> &str

Performs the conversion.

impl<'a> Clone for ParsedUriQualifiedName<'a>

pub fn clone(&self) -> ParsedUriQualifiedName<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ParsedUriQualifiedName<'a>

impl<'_> Debug for ParsedUriQualifiedName<'_>

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

Formats the value using the given formatter.

impl<'_> Display for ParsedUriQualifiedName<'_>

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

Formats the value using the given formatter.

impl<'a> Eq for ParsedUriQualifiedName<'a>

impl<'a> From<&'a UriQualifiedName> for ParsedUriQualifiedName<'a>

pub fn from(s: &'a UriQualifiedName) -> Self

Performs the conversion.

impl<'a> From<ParsedUriQualifiedName<'a>> for &'a UriQualifiedName

pub fn from(s: ParsedUriQualifiedName<'a>) -> Self

Performs the conversion.

impl<'a> Hash for ParsedUriQualifiedName<'a>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<'a> Ord for ParsedUriQualifiedName<'a>

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

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<'_, '_> PartialEq<&'_ ParsedUriQualifiedName<'_>> for str

pub fn eq(&self, o: &&ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<&'_ String> for ParsedUriQualifiedName<'_>

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<&'_ str> for ParsedUriQualifiedName<'_>

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<Box<str, Global>> for ParsedUriQualifiedName<'_>

pub fn eq(&self, other: &Box<str>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<Cow<'_, str>> for ParsedUriQualifiedName<'_>

pub fn eq(&self, other: &Cow<'_, str>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<ParsedUriQualifiedName<'_>> for str

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<ParsedUriQualifiedName<'_>> for &'_ str

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<ParsedUriQualifiedName<'_>> for String

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<ParsedUriQualifiedName<'_>> for &'_ String

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<ParsedUriQualifiedName<'_>> for Box<str>

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<ParsedUriQualifiedName<'_>> for Cow<'_, str>

pub fn eq(&self, o: &ParsedUriQualifiedName<'_>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a> PartialEq<ParsedUriQualifiedName<'a>> for ParsedUriQualifiedName<'a>

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

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

pub fn ne(&self, other: &ParsedUriQualifiedName<'a>) -> bool

This method tests for !=.

impl<'_> PartialEq<String> for ParsedUriQualifiedName<'_>

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<str> for ParsedUriQualifiedName<'_>

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialEq<str> for &'_ ParsedUriQualifiedName<'_>

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_, '_> PartialOrd<&'_ ParsedUriQualifiedName<'_>> for str

pub fn partial_cmp(&self, o: &&ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_> PartialOrd<ParsedUriQualifiedName<'_>> for str

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_, '_> PartialOrd<ParsedUriQualifiedName<'_>> for &'_ str

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_> PartialOrd<ParsedUriQualifiedName<'_>> for String

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_, '_> PartialOrd<ParsedUriQualifiedName<'_>> for &'_ String

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_> PartialOrd<ParsedUriQualifiedName<'_>> for Box<str>

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'_, '_> PartialOrd<ParsedUriQualifiedName<'_>> for Cow<'_, str>

pub fn partial_cmp(&self, o: &ParsedUriQualifiedName<'_>) -> Option<Ordering>

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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> PartialOrd<ParsedUriQualifiedName<'a>> for ParsedUriQualifiedName<'a>

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

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

pub fn lt(&self, other: &ParsedUriQualifiedName<'a>) -> bool

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

pub fn le(&self, other: &ParsedUriQualifiedName<'a>) -> bool

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

pub fn gt(&self, other: &ParsedUriQualifiedName<'a>) -> bool

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

pub fn ge(&self, other: &ParsedUriQualifiedName<'a>) -> bool

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

impl<'a> StructuralEq for ParsedUriQualifiedName<'a>

impl<'a> StructuralPartialEq for ParsedUriQualifiedName<'a>

impl<'a> TryFrom<&'a str> for ParsedUriQualifiedName<'a>

type Error = NameError

The type returned in the event of a conversion error.

pub fn try_from(s: &'a str) -> Result<Self, Self::Error>

Performs the conversion.