[]Struct rocket::http::uri::Absolute

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

A URI with a scheme, authority, path, and query: http://user:pass@domain.com:4444/path?query.

Structure

The following diagram illustrates the syntactic structure of an absolute URI with all optional parts:

 http://user:pass@domain.com:4444/path?query
 |--|   |-----------------------||---------|
scheme          authority          origin

The scheme part of the absolute URI and at least one of authority or origin are required.

Methods

impl<'a> Absolute<'a>

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

Example

use rocket::http::uri::Absolute;

// Parse a valid authority URI.
let uri = Absolute::parse("http://google.com").expect("valid URI");
assert_eq!(uri.scheme(), "http");
assert_eq!(uri.authority().unwrap().host(), "google.com");
assert_eq!(uri.origin(), None);

Returns the scheme part of the absolute URI.

Example

use rocket::http::uri::Absolute;

let uri = Absolute::parse("ftp://127.0.0.1").expect("valid URI");
assert_eq!(uri.scheme(), "ftp");

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

Example

use rocket::http::uri::Absolute;

let uri = Absolute::parse("https://rocket.rs:80").expect("valid URI");
assert_eq!(uri.scheme(), "https");
let authority = uri.authority().unwrap();
assert_eq!(authority.host(), "rocket.rs");
assert_eq!(authority.port(), Some(80));

let uri = Absolute::parse("file:/web/home").expect("valid URI");
assert_eq!(uri.authority(), None);

Returns the origin part of the absolute URI, if there is one.

Example

use rocket::http::uri::Absolute;

let uri = Absolute::parse("file:/web/home.html?new").expect("valid URI");
assert_eq!(uri.scheme(), "file");
let origin = uri.origin().unwrap();
assert_eq!(origin.path(), "/web/home.html");
assert_eq!(origin.query(), Some("new"));

let uri = Absolute::parse("https://rocket.rs").expect("valid URI");
assert_eq!(uri.origin(), None);

Trait Implementations

impl<'a> IntoOwned for Absolute<'a>

The owned version of the type.

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

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

This method tests for !=.

impl<'a> Clone for Absolute<'a>

Performs copy-assignment from source. Read more

impl<'a> Display for Absolute<'a>

impl<'a> Debug for Absolute<'a>

Auto Trait Implementations

impl<'a> Send for Absolute<'a>

impl<'a> Sync for Absolute<'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,