Struct iref::IriRef

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

IRI-reference slice.

Wrapper around a borrowed bytes slice representing an IRI-reference. An IRI-reference can be seen as an Iri with an optional Scheme. IRI-references are resolved against a base IRI into a proper IRI using the Reference Resolution Algorithm provided by the resolved method.

Example

let base_iri = Iri::new("http://a/b/c/d;p?q")?;
let mut iri_ref = IriRefBuf::new("g;x=1/../y")?;

assert_eq!(iri_ref.resolved(base_iri), "http://a/b/c/y");

Implementations

impl<'a> IriRef<'a>

pub fn new<S: AsRef<[u8]> + ?Sized>(buffer: &'a S) -> Result<IriRef<'a>, Error>

Create a new IRI-reference slice from a bytes slice.

This may fail if the source slice is not UTF-8 encoded, or if is not a valid IRI-reference.

pub fn parsing_data(&self) -> ParsedIriRef

Get the underlying parsing data.

pub const unsafe fn from_raw(data: &'a [u8], p: ParsedIriRef) -> IriRef<'a>

Build an IRI reference from a slice and parsing data.

This is unsafe since the input slice is not checked against the given parsing data.

pub fn len(&self) -> usize

Get the length is the IRI-reference, in bytes.

pub fn as_ref(&self) -> &[u8]

Get a reference to the underlying bytes slice representing the IRI-reference.

pub fn into_ref(self) -> &'a [u8]

Convert the IRI-refrence into its underlying bytes slice.

pub fn as_str(&self) -> &str

Get the IRI-reference as a string slice.

pub fn into_str(self) -> &'a str

Convert the IRI-reference into a string slice.

pub fn as_pct_str(&self) -> &PctStr

Get the IRI-reference as a percent-encoded string slice.

pub fn into_pct_str(self) -> &'a PctStr

Convert the IRI-reference into a percent-encoded string slice.

pub fn scheme(&self) -> Option<Scheme<'_>>

Get the scheme of the IRI-reference.

The scheme is located at the very begining of the IRI-reference and delimited by an ending :.

Example

assert_eq!(IriRef::new("foo://example.com:8042").unwrap().scheme().unwrap(), "foo");
assert_eq!(IriRef::new("//example.com:8042").unwrap().scheme(), None);

pub fn authority(&self) -> Option<Authority<'_>>

Get the authority of the IRI-reference.

The authority is delimited by the // string, after the scheme.

Example

assert_eq!(IriRef::new("foo://example.com:8042").unwrap().authority().unwrap().host(), "example.com");
assert_eq!(IriRef::new("foo:").unwrap().authority(), None);

pub fn path(&'a self) -> Path<'a>

Get the path of the IRI-reference.

The path is located just after the authority. It is always defined, even if empty.

Example

assert_eq!(IriRef::new("foo:/a/b/c?query").unwrap().path(), "/a/b/c");
assert!(IriRef::new("foo:#fragment").unwrap().path().is_empty());

pub fn query(&self) -> Option<Query<'_>>

Get the query of the IRI-reference.

The query part is delimited by the ? character after the path.

Example

assert_eq!(IriRef::new("//example.org?query").unwrap().query().unwrap(), "query");
assert!(IriRef::new("//example.org/foo/bar#fragment").unwrap().query().is_none());

pub fn fragment(&self) -> Option<Fragment<'_>>

Get the fragment of the IRI-reference.

The fragment part is delimited by the # character after the query.

Example

assert_eq!(IriRef::new("//example.org#foo").unwrap().fragment().unwrap(), "foo");
assert!(IriRef::new("//example.org").unwrap().fragment().is_none());

pub fn into_iri(self) -> Result<Iri<'a>, IriRef<'a>>

Convert the IRI-reference into an IRI, if possible.

An IRI-reference is a valid IRI only if it has a defined Scheme.

pub fn resolved<'b, Base: Into<Iri<'b>>>(&self, base_iri: Base) -> IriBuf

Resolve the IRI reference against the given base IRI.

Return the resolved IRI. See the IriRefBuf::resolve method for more informations about the resolution process.

pub fn suffix<'b, Prefix: Into<IriRef<'b>>>(
    &self,
    prefix: Prefix
) -> Option<(PathBuf, Option<Query<'_>>, Option<Fragment<'_>>)>

Get the suffix of this IRI reference, if any, with regard to the given prefix IRI reference..

Returns Some((suffix, query, fragment)) if this IRI reference is of the form prefix/suffix?query#fragment where prefix is given as parameter. Returns None otherwise. If the suffix scheme or authority is different from this path, it will return None.

See Path::suffix for more details.

pub fn base(&self) -> IriRef<'_>

The IRI reference without the file name, query and fragment.

Example

let a = IriRef::new("https://crates.io/crates/iref?query#fragment").unwrap();
let b = IriRef::new("https://crates.io/crates/iref/?query#fragment").unwrap();
assert_eq!(a.base(), "https://crates.io/crates/");
assert_eq!(b.base(), "https://crates.io/crates/iref/")

pub fn relative_to<'b, Other: Into<IriRef<'b>>>(
    &self,
    other: Other
) -> IriRefBuf

Get this IRI reference relatively to the given one.

Example

let a = IriRef::new("https://crates.io/").unwrap();
let b = IriRef::new("https://crates.io/crates/iref").unwrap();
let c = IriRef::new("https://crates.io/crates/json-ld").unwrap();
assert_eq!(b.relative_to(a), "crates/iref");
assert_eq!(a.relative_to(b), "https://crates.io/");
assert_eq!(b.relative_to(c), "iref");
assert_eq!(c.relative_to(b), "json-ld");

Trait Implementations

impl<'a> AsIriRef for IriRef<'a>

fn as_iri_ref(&self) -> IriRef<'_>

impl<'a> Clone for IriRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for IriRef<'a>

impl<'a> Debug for IriRef<'a>

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

Formats the value using the given formatter.

impl<'a> Display for IriRef<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for IriRef<'a>

impl<'a> From<&'a IriBuf> for IriRef<'a>

fn from(iri_ref_buf: &'a IriBuf) -> IriRef<'a>

Performs the conversion.

impl<'a> From<&'a IriRef<'a>> for IriRefBuf

fn from(iri_ref: &'a IriRef<'a>) -> IriRefBuf

Performs the conversion.

impl<'a> From<&'a IriRefBuf> for IriRef<'a>

fn from(iri_ref_buf: &'a IriRefBuf) -> IriRef<'a>

Performs the conversion.

impl<'a> From<&'a PathBuf> for IriRef<'a>

fn from(path: &'a PathBuf) -> IriRef<'a>

Performs the conversion.

impl<'a> From<Iri<'a>> for IriRef<'a>

fn from(iri: Iri<'a>) -> IriRef<'a>

Performs the conversion.

impl<'a> From<IriRef<'a>> for IriRefBuf

fn from(iri_ref: IriRef<'a>) -> IriRefBuf

Performs the conversion.

impl<'a> From<Path<'a>> for IriRef<'a>

fn from(path: Path<'a>) -> IriRef<'a>

Performs the conversion.

impl<'a> Hash for IriRef<'a>

fn hash<H: Hasher>(&self, hasher: &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> Ord for IriRef<'a>

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'a> PartialEq<&'a str> for IriRef<'a>

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

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

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

This method tests for !=.

impl<'a> PartialEq<Iri<'a>> for IriRef<'a>

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

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

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

This method tests for !=.

impl<'a> PartialEq<IriBuf> for IriRef<'a>

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

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

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

This method tests for !=.

impl<'a> PartialEq<IriRef<'a>> for IriBuf

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

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

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

This method tests for !=.

impl<'a> PartialEq<IriRef<'a>> for Iri<'a>

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

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

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

This method tests for !=.

impl<'a> PartialEq<IriRef<'a>> for IriRefBuf

fn eq(&self, iri_ref: &IriRef<'a>) -> bool

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

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

This method tests for !=.

impl<'a> PartialEq<IriRef<'a>> for IriRef<'a>

fn eq(&self, other: &IriRef<'_>) -> bool

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

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

This method tests for !=.

impl<'a> PartialEq<IriRefBuf> for IriRef<'a>

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

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

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

This method tests for !=.

impl<'a> PartialOrd<Iri<'a>> for IriRef<'a>

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

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriBuf> for IriRef<'a>

fn partial_cmp(&self, other: &IriBuf) -> Option<Ordering>

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriRef<'a>> for IriBuf

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

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriRef<'a>> for Iri<'a>

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

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriRef<'a>> for IriRefBuf

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

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriRef<'a>> for IriRef<'a>

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

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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<IriRefBuf> for IriRef<'a>

fn partial_cmp(&self, other: &IriRefBuf) -> Option<Ordering>

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

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

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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> TryFrom<IriRef<'a>> for IriBuf

type Error = Error

The type returned in the event of a conversion error.

fn try_from(iri_ref: IriRef<'a>) -> Result<IriBuf, Error>

Performs the conversion.

impl<'a> TryFrom<IriRef<'a>> for Iri<'a>

type Error = IriRef<'a>

The type returned in the event of a conversion error.

fn try_from(iri_ref: IriRef<'a>) -> Result<Iri<'a>, IriRef<'a>>

Performs the conversion.