Enum UriType

pub enum UriType {
    Uri,
    UriNoAuthority,
    UriCannotBeABase,
    NetworkPath,
    AbsolutePath,
    RelativePath,
    Query,
    Fragment,
}

Enum describing the type of a URI.

Variants

Uri

An IETF-RFC3986 “URI”, including both scheme and authority components; E.g. http://example.com/abcd

assert_eq!(UriType::Uri, uri_ref!("http://example.com/abcd").uri_type());

URI references with this type can borrowed as a &Uri.

UriNoAuthority

An IETF-RFC3986 “URI” that has a scheme but no authority component, where the path begins with a slash; E.g. unix:/run/foo.socket

assert_eq!(UriType::UriNoAuthority, uri_ref!("unix:/run/foo.socket").uri_type());

URI references with this type can borrowed as a &Uri.

UriCannotBeABase

An IETF-RFC3986 “URI” that has a scheme but no authority component, where the path does not start with a slash (/); E.g. tel:+1-555-867-5309

assert_eq!(UriType::UriCannotBeABase, uri_ref!("tel:+1-555-867-5309").uri_type());

URI references with this type can borrowed as a &Uri.

NetworkPath

An IETF-RFC3986 “network-path” that has an authority component but no scheme; E.g. //example.com/foo/bar?q

assert_eq!(UriType::NetworkPath, uri_ref!("//example.com/foo/bar").uri_type());

Note that according to IETF-RFC3986 this is a “relative-reference”, but because it includes an authority this library considers it to be borrowable as a &Uri.

AbsolutePath

An IETF-RFC3986 “relative-reference” with a “path-absolute” and optionally a query and/or fragment; E.g. /foo/bar?q

assert_eq!(UriType::AbsolutePath, uri_ref!("/foo/bar?q").uri_type());

URI references with this type can borrowed as a &RelRef.

RelativePath

An IETF-RFC3986 “relative-reference” with a “path-rootless” and optionally a query and/or fragment; E.g. foo/bar?q

An empty URI reference has this type, but the path is guaranteed to have a non-zero length if a query or fragment is present.

assert_eq!(UriType::RelativePath, uri_ref!("foo/bar?q").uri_type());
assert_eq!(UriType::RelativePath, uri_ref!("").uri_type());

URI references with this type can borrowed as a &RelRef.

Query

An IETF-RFC3986 “relative-reference” with a “path-empty”, a query, and optionally a fragment; E.g. ?q=blah, ?q=blah#foo-bar

assert_eq!(UriType::Query, uri_ref!("?q=blah").uri_type());
assert_eq!(UriType::Query, uri_ref!("?q=blah#foo-bar").uri_type());

URI references with this type can borrowed as a &RelRef.

Fragment

An IETF-RFC3986 “relative-reference” that includes only a fragment component; E.g. #foo-bar

assert_eq!(UriType::Fragment, uri_ref!("#foo-bar").uri_type());

URI references with this type can borrowed as a &RelRef.

Implementations

impl UriType

pub fn can_borrow_as_uri(&self) -> bool

Returns true if this type can be borrowed as a [&Uri], false otherwise.

pub fn can_borrow_as_rel_ref(&self) -> bool

Returns true if this type can be borrowed as a [&RelRef], false otherwise.

pub fn has_absolute_path(&self) -> bool

Returns true if this type can be assumed to have an absolute path.

pub fn is_ietf_rfc3986_relative_reference(&self) -> bool

Returns true if IETF-RFC3986 considers this type to be a “relative-reference”.

pub fn cannot_be_a_base(&self) -> bool

Returns true if this type cannot be used as a base when performing URI reference resolution.

Trait Implementations

impl Clone for UriType

fn clone(&self) -> UriType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UriType

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

Formats the value using the given formatter.

impl Hash for UriType

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

where __H: Hasher,

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UriType

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for UriType

impl Eq for UriType

impl StructuralPartialEq for UriType