Struct http_req::uri::Uri

pub struct Uri { /* fields omitted */ }

Representation of Uniform Resource Identifier

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.host(), Some("foo.com"));

Methods

impl Uri

pub fn scheme(&self) -> &str

Returns scheme of this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.scheme(), "https");

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

Returns information about the user included in this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.user_info(), Some("user:info"));

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

Returns host of this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.host(), Some("foo.com"));

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

Returns host of this Uri to use in a header.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.host_header(), Some("foo.com:12".to_string()));

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

Returns port of this Uri

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.port(), Some(12));

pub fn corr_port(&self) -> u16

Returns port corresponding to this Uri. Returns default port if it hasn't been set in the uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.corr_port(), 12);

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

Returns path of this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.path(), Some("/bar/baz"));

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

Returns query of this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.query(), Some("query"));

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

Returns fragment of this Uri.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.fragment(), Some("fragment"));

pub fn resource(&self) -> &str

Returns resource Uri points to.

Example

use http_req::uri::Uri;

let uri: Uri = "https://user:info@foo.com:12/bar/baz?query#fragment".parse().unwrap();
assert_eq!(uri.resource(), "/bar/baz?query#fragment");

Trait Implementations

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, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl FromStr for Uri

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl PartialEq<Uri> for Uri

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

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

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

This method tests for !=.

impl StructuralPartialEq for Uri