Struct iri_string::absolute::AbsoluteIri

pub struct AbsoluteIri { /* fields omitted */ }

Absolute IRI and resolved URI.

Comparations (PartialEq, Eq, PartialOrd, Ord, Hash implementations) are done by raw IRI comparison (returned by [AbsoluteIri::raw]), not by resolved one (returned by [AbsoluteIri::resolved]).

Methods

impl AbsoluteIri

pub fn new<S: AsRef<str> + Into<String>>(s: S) -> Result<Self, UrlParseError>

Creates a new AbsoluteIri.

Examples

let s = "https://例.example.com/example/テスト";
assert!(AbsoluteIri::new(s).is_ok());
assert!(AbsoluteIri::new("not-absolute-iri").is_err());

pub fn raw(&self) -> &AbsoluteIriStr

Returns raw IRI string slice.

Examples

let s = "https://例.example.com/example/テスト";
let iri = AbsoluteIri::new(s).expect("Should never fail");
assert_eq!(iri.raw(), s);

pub fn resolved(&self) -> &Url

Returns reference to the resolved URI.

Examples

let s = "https://例.example.com/example/テスト";
let resolved = "https://xn--fsq.example.com/example/%E3%83%86%E3%82%B9%E3%83%88";
let iri = AbsoluteIri::new(s).expect("Should never fail");
assert_eq!(iri.resolved().as_str(), resolved);

pub fn deconstruct(self) -> (AbsoluteIriString, Url)

Deconstructs AbsoluteIri into [AbsoluteIriString] and [Url].

Examples

let s = "https://例.example.com/example/テスト";
let resolved_str = "https://xn--fsq.example.com/example/%E3%83%86%E3%82%B9%E3%83%88";

let iri = AbsoluteIri::new(s).expect("Should never fail");
let (raw, resolved) = iri.deconstruct();
assert_eq!(raw, s);
assert_eq!(resolved.as_str(), resolved_str);

Trait Implementations

impl Debug for AbsoluteIri

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

Formats the value using the given formatter.

impl Clone for AbsoluteIri

fn clone(&self) -> AbsoluteIri

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for AbsoluteIri

fn eq(&self, rhs: &AbsoluteIri) -> 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 Eq for AbsoluteIri

impl PartialOrd for AbsoluteIri

fn partial_cmp(&self, rhs: &AbsoluteIri) -> 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 Ord for AbsoluteIri

fn cmp(&self, rhs: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

impl Hash for AbsoluteIri

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 Serialize for AbsoluteIri

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for AbsoluteIri

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.