Struct url::RelativeSchemeData

pub struct RelativeSchemeData {
    pub username: String,
    pub password: Option<String>,
    pub host: Host,
    pub port: Option<u16>,
    pub default_port: Option<u16>,
    pub path: Vec<String>,
}

Components for URLs in a relative scheme such as HTTP.

Fields

username: String

The username of the URL, as a possibly empty, percent-encoded string.

Percent encoded strings are within the ASCII range.

See also the lossy_percent_decode_username method.

password: Option<String>

The password of the URL.

None if the : delimiter character was not part of the parsed input, otherwise a possibly empty, percent-encoded string.

Percent encoded strings are within the ASCII range.

See also the lossy_percent_decode_password method.

host: Host

The host of the URL, either a domain name or an IPv4 address

port: Option<u16>

The port number of the URL. None for file-like schemes, or to indicate the default port number.

default_port: Option<u16>

The default port number for the URL’s scheme. None for file-like schemes.

path: Vec<String>

The path of the URL, as vector of percent-encoded strings.

Percent encoded strings are within the ASCII range.

See also the serialize_path method and, for URLs in the file scheme, the to_file_path method.

Methods

impl RelativeSchemeData

pub fn lossy_percent_decode_username(&self) -> String

Percent-decode the URL’s username.

This is “lossy”: invalid UTF-8 percent-encoded byte sequences will be replaced � U+FFFD, the replacement character.

pub fn lossy_percent_decode_password(&self) -> Option<String>

Percent-decode the URL’s password, if any.

This is “lossy”: invalid UTF-8 percent-encoded byte sequences will be replaced � U+FFFD, the replacement character.

pub fn to_file_path(&self) -> Result<PathBuf, ()>

Assuming the URL is in the file scheme or similar, convert its path to an absolute std::path::Path.

Note: This does not actually check the URL’s scheme, and may give nonsensical results for other schemes. It is the user’s responsibility to check the URL’s scheme before calling this.

let path = url.to_file_path();

Returns Err if the host is neither empty nor "localhost", or if Path::new_opt() returns None. (That is, if the percent-decoded path contains a NUL byte or, for a Windows path, is not UTF-8.)

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

If the host is a domain, return the domain as a string.

pub fn domain_mut(&mut self) -> Option<&mut String>

If the host is a domain, return a mutable reference to the domain string.

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

Return the port number of the URL, even if it is the default. Return None for file-like URLs.

pub fn serialize_path(&self) -> String

Serialize the path as a string.

The returned string starts with a "/" slash, and components are separated by slashes. A trailing slash represents an empty last component.

pub fn serialize_userinfo(&self) -> String

Serialize the userinfo as a string.

Format: ":@".

Trait Implementations

impl Clone for RelativeSchemeData

fn clone(&self) -> RelativeSchemeData

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RelativeSchemeData

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

Formats the value using the given formatter.

impl PartialEq for RelativeSchemeData

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

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

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

This method tests for !=.

impl Eq for RelativeSchemeData

impl Hash for RelativeSchemeData

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,

Feeds a slice of this type into the given [Hasher].

impl PartialOrd for RelativeSchemeData

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

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

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

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

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

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

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

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

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 Ord for RelativeSchemeData

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

impl Display for RelativeSchemeData

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

Formats the value using the given formatter.