Struct hyper::Uri

[+] Show declaration

pub struct Uri { /* fields omitted */ }

[−] Expand description

The Request-URI of a Request's StartLine.

From Section 5.3, Request Target:

Once an inbound connection is obtained, the client sends an HTTP request message (Section 3) with a request-target derived from the target URI. There are four distinct formats for the request-target, depending on both the method being requested and whether the request is to a proxy.

request-target = origin-form
               / absolute-form
               / authority-form
               / asterisk-form

Uri explanations

abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
|-|   |-------------------------------||--------| |-------------------| |-----|
 |                  |                       |               |              |
scheme          authority                 path            query         fragment

Methods

impl Uri[−]

pub fn path(&self) -> &str[−]

Get the path of this Uri.

pub fn scheme(&self) -> Option<&str>[−]

Get the scheme of this Uri.

pub fn authority(&self) -> Option<&str>[−]

Get the authority of this Uri.

pub fn host(&self) -> Option<&str>[−]

Get the host of this Uri.

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

Get the port of this Uri.

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

Get the query string of this Uri, starting after the ?.

pub fn is_absolute(&self) -> bool[−]

Returns whether this URI is in absolute-form.

An example of absolute form is https://hyper.rs.

Trait Implementations

impl AsRef<str> for Uri[+]

[+] Show hidden undocumented items

fn as_ref(&self) -> &str[−]

Performs the conversion.

impl Clone for Uri[+]

[+] Show hidden undocumented items

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[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Default for Uri[+]

[+] Show hidden undocumented items

fn default() -> Uri[−]

Returns the "default value" for a type.

impl Display for Uri[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Eq for Uri

impl FromStr for Uri[+]

[+] Show hidden undocumented items

type Err = UriError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Uri, UriError>[−]

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

impl Hash for Uri[+]

[+] Show hidden undocumented items

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<'a> PartialEq<&'a str> for Uri[+]

[+] Show hidden undocumented items

fn eq(&self, other: &&'a str) -> bool[−]

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

[+] Expand attributes

#[must_use] fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.

impl PartialEq<Uri> for Uri[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Uri) -> bool[−]

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

[+] Expand attributes

#[must_use] fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.

impl<'a> PartialEq<Uri> for &'a str[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Uri) -> bool[−]

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

[+] Expand attributes

#[must_use] fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.

impl PartialEq<str> for Uri[+]

[+] Show hidden undocumented items

fn eq(&self, other: &str) -> bool[−]

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

[+] Expand attributes

#[must_use] fn ne(&self, other: &Rhs) -> bool[−]

This method tests for !=.