Struct Uri

pub struct Uri { /* private fields */ }

Encapsulates the URI type.

Implementations

impl Uri

pub fn try_new(uri: &str) -> Result<Self>

Attempts to construct a Uri from a raw string slice. A file:// protocol is assumed if not specified. File URIs are resolved (normalized) relative to the current working directory unless an absolute path is specified. Handles special characters like ~, ., ...

pub fn new(uri: String) -> Self

Constructs a Uri from a properly formatted string <protocol>://<path> where path is normalized. Use this method exclusively for trusted input.

pub fn extension(&self) -> Option<Extension>

Returns the extension of the URI.

pub fn as_str(&self) -> &str

Returns the URI as a string slice.

pub fn protocol(&self) -> &str

Returns the protocol of the URI.

pub fn filepath(&self) -> Option<&Path>

Returns the file path of the URI. Applies only to file:// URIs.

pub fn into_string(self) -> String

Consumes the Uri struct and returns the normalized URI as a string.

pub fn join(&self, path: &str) -> Result<Self>

Creates a new Uri with path adjoined to self. Fails if path is absolute.

Trait Implementations

impl AsRef<str> for Uri

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Uri

fn clone(&self) -> Uri

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Uri

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

Formats the value using the given formatter.

impl Display for Uri

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

Formats the value using the given formatter.

impl Hash for Uri

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<&str> for Uri

fn eq(&self, other: &&str) -> 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 PartialEq<String> for Uri

fn eq(&self, other: &String) -> 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 PartialEq for Uri

fn eq(&self, other: &Uri) -> 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 Serialize for Uri

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Uri

impl StructuralPartialEq for Uri