[−][src]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>`[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.

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

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

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

`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.

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

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

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> Clone for Authority<'a>`[src]

`fn clone(&self) -> Authority<'a>`[src]

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

Performs copy-assignment from source. Read more

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

`type Owned = Authority<'static>`

The owned version of the type.

`fn into_owned(self) -> Authority<'static>`[src]

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

`fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

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

`fn from(other: Authority<'a>) -> Uri<'a>`[src]

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

`fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

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

`fn eq(&self, other: &Authority<'b>) -> bool`[src]

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

This method tests for !=.

Auto Trait Implementations

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

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

Blanket Implementations

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

`type Owned = T`

The resulting type after obtaining ownership.

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

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

`default fn to_string(&self) -> String`[src]

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

`fn from(t: T) -> T`[src]

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

`fn into(self) -> U`[src]

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

`type Error = Infallible`

The type returned in the event of a conversion error.

`fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>`[src]

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

`type Error = >::Error`

The type returned in the event of a conversion error.

`fn try_into(self) -> Result<U, >::Error>`[src]

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

`fn borrow_mut(&mut self) -> &mut T`[src]

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

`fn borrow(&self) -> &T`[src]

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

`fn type_id(&self) -> TypeId`[src]

`impl<T> Typeable for T where T: Any,`

`fn get_type(&self) -> TypeId`

Get the TypeId of this object.

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

ⓘImportant traits for SmallVec<A>
Important traits for SmallVec<A>
`impl<A> Write for SmallVec<A> where A: Array<Item = u8>,`
`fn into_collection<A>(self) -> SmallVec<A> where A: Array<Item = T>,` [src]

ⓘImportant traits for SmallVec<A>
Important traits for SmallVec<A>
`impl<A> Write for SmallVec<A> where A: Array<Item = u8>,`
`fn mapped<U, F, A>(self, f: F) -> SmallVec<A> where A: Array<Item = U>, F: FnMut(T) -> U,` [src]

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

Structure

Methods

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

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

Example

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

Example

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

Example

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

Example

Trait Implementations

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

fn clone(&self) -> Authority<'a>[src]

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

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

type Owned = Authority<'static>

fn into_owned(self) -> Authority<'static>[src]

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

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

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

fn from(other: Authority<'a>) -> Uri<'a>[src]

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

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

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

fn eq(&self, other: &Authority<'b>) -> bool[src]

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

Auto Trait Implementations

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

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

Blanket Implementations

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

type Owned = T

fn to_owned(&self) -> T[src]

fn clone_into(&self, target: &mut T)[src]

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

default fn to_string(&self) -> String[src]

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

fn from(t: T) -> T[src]

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

fn into(self) -> U[src]

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

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

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

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

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

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

fn borrow_mut(&mut self) -> &mut T[src]

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

fn borrow(&self) -> &T[src]

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

fn type_id(&self) -> TypeId[src]

impl<T> Typeable for T where T: Any,

fn get_type(&self) -> TypeId

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

ⓘImportant traits for SmallVec<A>Important traits for SmallVec<A>impl<A> Write for SmallVec<A> where A: Array<Item = u8>, fn into_collection<A>(self) -> SmallVec<A> where A: Array<Item = T>, [src]

Important traits for SmallVec<A>

ⓘImportant traits for SmallVec<A>Important traits for SmallVec<A>impl<A> Write for SmallVec<A> where A: Array<Item = u8>, fn mapped<U, F, A>(self, f: F) -> SmallVec<A> where A: Array<Item = U>, F: FnMut(T) -> U, [src]

Important traits for SmallVec<A>

impl<T, I> AsResult<T, I> for T where I: Input, [src]

fn as_result(self) -> Result<T, ParseErr<I>>[src]

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

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

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

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

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

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

`fn clone(&self) -> Authority<'a>`[src]

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

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

`type Owned = Authority<'static>`

`fn into_owned(self) -> Authority<'static>`[src]

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

`fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

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

`fn from(other: Authority<'a>) -> Uri<'a>`[src]

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

`fn fmt(&self, f: &mut Formatter) -> Result<(), Error>`[src]

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

`fn eq(&self, other: &Authority<'b>) -> bool`[src]

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

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

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

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

`type Owned = T`

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

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

`default fn to_string(&self) -> String`[src]

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

`fn from(t: T) -> T`[src]

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

`fn into(self) -> U`[src]

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

`type Error = Infallible`

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

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

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

`fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src]

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

`fn borrow_mut(&mut self) -> &mut T`[src]

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

`fn borrow(&self) -> &T`[src]

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

`fn type_id(&self) -> TypeId`[src]

`impl<T> Typeable for T where T: Any,`

`fn get_type(&self) -> TypeId`

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

ⓘImportant traits for SmallVec<A>
Important traits for SmallVec<A>
`impl<A> Write for SmallVec<A> where A: Array<Item = u8>,`
`fn into_collection<A>(self) -> SmallVec<A> where A: Array<Item = T>,` [src]

ⓘImportant traits for SmallVec<A>
Important traits for SmallVec<A>
`impl<A> Write for SmallVec<A> where A: Array<Item = u8>,`
`fn mapped<U, F, A>(self, f: F) -> SmallVec<A> where A: Array<Item = U>, F: FnMut(T) -> U,` [src]

`impl<T, I> AsResult<T, I> for T where I: Input,` [src]

`fn as_result(self) -> Result<T, ParseErr<I>>`[src]