[−][src]Struct rocket_http::uri::Authority
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> IntoOwned for Authority<'a>
[src]
type Owned = Authority<'static>
The owned version of the type.
fn into_owned(self) -> Authority<'static>
[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]
Performs copy-assignment from source
. Read more
impl<'a> From<Authority<'a>> for Uri<'a>
[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 !=
.
impl<'a> Debug for Authority<'a>
[src]
impl<'a> Display for Authority<'a>
[src]
Auto Trait Implementations
impl<'a> Sync for Authority<'a>
impl<'a> Unpin for Authority<'a>
impl<'a> Send for Authority<'a>
impl<'a> UnwindSafe for Authority<'a>
impl<'a> RefUnwindSafe for Authority<'a>
Blanket Implementations
impl<T> IntoCollection<T> for T
[src]
ⓘImportant traits for SmallVec<A>fn into_collection<A>(Self) -> SmallVec<A> where
A: Array<Item = T>,
[src]
A: Array<Item = T>,
ⓘImportant traits for SmallVec<A>fn mapped<U, F, A>(Self, F) -> SmallVec<A> where
A: Array<Item = U>,
F: FnMut(T) -> U,
[src]
A: Array<Item = U>,
F: FnMut(T) -> U,
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
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, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
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]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T, I> AsResult<T, I> for T where
I: Input,
[src]
I: Input,
impl<T> Typeable for T where
T: Any,
T: Any,