[][src]Struct rocket_http::uri::Authority

pub struct Authority<'a> { /* fields omitted */ }

A URI with an authority only: user:pass@host:8000.


The following diagram illustrates the syntactic structure of an authority URI:

|---------------| |-------| |--|
    user info        host   port

Only the host part of the URI is required.


impl<'a> Authority<'a>[src]

pub fn parse(string: &'a str) -> Result<Authority<'a>, Error<'a>>[src]

Parses the string string into an Authority. Parsing will never allocate. Returns an Error if string is not a valid authority URI.


use rocket::http::uri::Authority;

// Parse a valid authority URI.
let uri = Authority::parse("user:pass@host").expect("valid URI");
assert_eq!(uri.user_info(), Some("user:pass"));
assert_eq!(uri.host(), "host");
assert_eq!(uri.port(), None);

// Invalid authority URIs fail to parse.
Authority::parse("http://google.com").expect_err("invalid authority");

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

Returns the user info part of the authority URI, if there is one.


use rocket::http::uri::Authority;

let uri = Authority::parse("username:password@host").unwrap();
assert_eq!(uri.user_info(), Some("username:password"));

pub fn host(&self) -> &str[src]

Returns the host part of the authority URI.

If the host was provided in brackets (such as for IPv6 addresses), the brackets will not be part of the returned string.


use rocket::http::uri::Authority;

let uri = Authority::parse("domain.com:123").unwrap();
assert_eq!(uri.host(), "domain.com");

let uri = Authority::parse("username:password@host:123").unwrap();
assert_eq!(uri.host(), "host");

let uri = Authority::parse("username:password@[1::2]:123").unwrap();
assert_eq!(uri.host(), "1::2");

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

Returns the port part of the authority URI, if there is one.


use rocket::http::uri::Authority;

// With a port.
let uri = Authority::parse("username:password@host:123").unwrap();
assert_eq!(uri.port(), Some(123));

let uri = Authority::parse("domain.com:8181").unwrap();
assert_eq!(uri.port(), Some(8181));

// Without a port.
let uri = Authority::parse("username:password@host").unwrap();
assert_eq!(uri.port(), None);

Trait Implementations

impl<'a> IntoOwned for Authority<'a>[src]

type Owned = Authority<'static>

The owned version of the type.

impl<'a, 'b> PartialEq<Authority<'b>> for Authority<'a>[src]

#[must_use] fn ne(&self, other: &Rhs) -> bool1.0.0[src]

This method tests for !=.

impl<'a> From<Authority<'a>> for Uri<'a>[src]

impl<'a> Clone for Authority<'a>[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl<'a> Debug for Authority<'a>[src]

impl<'a> Display for Authority<'a>[src]

Auto Trait Implementations

impl<'a> Send for Authority<'a>

impl<'a> Unpin for Authority<'a>

impl<'a> Sync for Authority<'a>

impl<'a> UnwindSafe for Authority<'a>

impl<'a> RefUnwindSafe for Authority<'a>

Blanket Implementations

impl<T> IntoCollection<T> for T[src]

impl<T> ToString for T where
    T: Display + ?Sized

impl<T> ToOwned for T where
    T: Clone

type Owned = T

The resulting type after obtaining ownership.

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> Any for T where
    T: 'static + ?Sized

impl<T, I> AsResult<T, I> for T where
    I: Input

impl<T> Typeable for T where
    T: Any

fn get_type(&self) -> TypeId

Get the TypeId of this object.