Struct iref::Iri[−][src]

pub struct Iri<'a>(_);

Expand description

IRI slice.

Wrapper around a borrowed bytes slice representing an IRI. An IRI can be seen as an IRI-reference with a defined Scheme. All methods of IriRef are available from this type, however the scheme method is redefined to always return some scheme.

Example

let iri = Iri::new("https://www.rust-lang.org/foo/bar?query#frag")?;

println!("scheme: {}", iri.scheme()); // note the absence of `unwrap` here since
                                      // the scheme is always defined in an IRI.
println!("authority: {}", iri.authority().unwrap());
println!("path: {}", iri.path());
println!("query: {}", iri.query().unwrap());
println!("fragment: {}", iri.fragment().unwrap());

Implementations

[src]

impl<'a> Iri<'a>

[src]

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

Create a new IRI slice from a bytes slice.

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

[src]

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

Create a new IRI from a string.

This replaces a std::str::FromStr implementation as the trait is incompatiple with the result storing the input which Iri does.

[src]

pub fn to_owned(self) -> IriBuf

Convert the slice-like Iri into the owned version IriBuf.

[src]

pub const fn from_iri_ref(iri_ref: IriRef<'a>) -> Iri<'a>

Build an IRI from an IRI reference.

[src]

pub fn as_iri_ref(&self) -> IriRef<'a>

Get an IriRef out of this IRI.

An IRI is always a valid IRI-reference.

[src]

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

Get the scheme of the IRI.

Contrarily to IriRef, the scheme of an IRI is always defined.

Methods from Deref<Target = IriRef<'a>>

[src]

pub fn parsing_data(&self) -> ParsedIriRef

Get the underlying parsing data.

[src]

pub fn len(&self) -> usize

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

[src]

pub fn is_empty(&self) -> bool

[src]

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

Returns a reference to the byte representation of the IRI-reference.

[src]

pub fn as_str(&self) -> &str

Get the IRI-reference as a string slice.

[src]

pub fn as_pct_str(&self) -> &PctStr

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

[src]

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);

[src]

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);

[src]

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());

[src]

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());

[src]

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());

[src]

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.

[src]

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.

[src]

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/")

[src]

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), "../");
assert_eq!(b.relative_to(c), "iref");
assert_eq!(c.relative_to(b), "json-ld");