[]Struct rocket::http::uri::Authority

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

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

Structure

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

username:password@some.host:8088
|---------------| |-------| |--|
    user info        host   port

Only the host part of the URI is required.

Methods

impl<'a> Authority<'a>

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

Example

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");

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

Example

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

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

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.

Example

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");

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

Example

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>

The owned version of the type.

impl<'a> From<Authority<'a>> for Uri<'a>

impl<'a, 'b> PartialEq<Authority<'b>> for Authority<'a>

This method tests for !=.

impl<'a> Clone for Authority<'a>

Performs copy-assignment from source. Read more

impl<'a> Display for Authority<'a>

impl<'a> Debug for Authority<'a>

Auto Trait Implementations

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

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

Blanket Implementations

impl<T> From for T
[src]

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

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> Borrow for T where
    T: ?Sized
[src]

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

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Typeable for T where
    T: Any

Get the TypeId of this object.

impl<T> IntoCollection for T

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