Struct Url 

pub struct Url { /* private fields */ }

URL representation.

Implementations

impl Url

pub fn scheme(&self) -> &str

Get the URL scheme.

pub fn auth(&self) -> Option<&str>

Get the auth string (if any).

pub fn username(&self) -> Option<&str>

Get the username (if any).

pub fn password(&self) -> Option<&str>

Get the password (if any).

pub fn netloc(&self) -> &str

Get the network location.

pub fn host(&self) -> &str

Get the host.

pub fn port(&self) -> Option<u16>

Get the port (if explicitly provided).

pub fn path(&self) -> &str

Get the path.

pub fn path_with_query(&self) -> &str

Get the path including the query string.

pub fn path_with_query_and_fragment(&self) -> &str

Get the path including the query string and the fragment.

pub fn query(&self) -> Option<&str>

Get the query string (if any).

pub fn fragment(&self) -> Option<&str>

Get the fragment (if any).

pub fn base_url(&self) -> Self

Create a new URL by stripping the path, query, and fragment.

pub fn with_auth(&self, auth: Option<&str>) -> Result<Self, UrlParseError>

Create a new URL with a given authentication string.

The authentication string must be URL-encoded.

pub fn with_credentials( &self, username: &str, password: &str, ) -> Result<Self, UrlParseError>

Create a new URL with a given username and password.

The username and password must be URL-encoded.

pub fn with_netloc(&self, netloc: &str) -> Result<Self, UrlParseError>

Create a new URL with a given network location.

pub fn with_query(&self, query: Option<&str>) -> Result<Self, UrlParseError>

Create a new URL with a given query string.

The query string must be URL-encoded.

pub fn with_fragment( &self, fragment: Option<&str>, ) -> Result<Self, UrlParseError>

Create a new URL with a given fragment.

The fragment must be URL-encoded.

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

Create a new URL by joining this URL with a given input.

The output will depend on the provided input:

• If the input is empty, the current URL is returned.
• If the input starts with //, the input is treated as an absolute URL without a scheme, and the scheme of the current URL is used.
• If the input starts with /, the input is treated as an absolute path and the path of the current URL is replaced with the input.
• If the input is an absolute URL, the input is returned as a new URL.
• Otherwise, the input is treated as a relative path and is appended to the current URL’s path, replacing the rightmost path segment.

Trait Implementations

impl AsRef<str> for Url

fn as_ref(&self) -> &str

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

impl Clone for Url

fn clone(&self) -> Url

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Display for Url

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

Formats the value using the given formatter.

impl FromStr for Url

type Err = UrlParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Url, UrlParseError>

Parses a string s to return a value of this type.

impl IntoUrl for &Url

fn into_url(self) -> Result<Url, UrlParseError>

Convert the object into URL.

impl IntoUrl for Url

fn into_url(self) -> Result<Url, UrlParseError>

Convert the object into URL.

impl TryFrom<String> for Url

type Error = UrlParseError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Url, UrlParseError>

Performs the conversion.