Struct iri_string::AbsoluteIri

pub struct AbsoluteIri { /* fields omitted */ }

Absolute IRI and resolved URI.

NOTE: For now, it does not derive {,Partial}{Eq,Ord} and Hash because it is not sure how they should be ordered or compared by default. If you want to compare them, use raw absolute IRI (by [AbsoluteIri::raw]) or resolved URI (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 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.