pub struct Authority { /* private fields */ }
Expand description
Represents the authority component of a URI.
Implementations§
source§impl Authority
impl Authority
sourcepub fn from_static(src: &'static str) -> Self
pub fn from_static(src: &'static str) -> Self
Attempt to convert an Authority
from a static string.
This function will not perform any copying, and the string will be checked if it is empty or contains an invalid character.
§Panics
This function panics if the argument contains invalid characters or is empty.
§Examples
let authority = Authority::from_static("example.com");
assert_eq!(authority.host(), "example.com");
Attempt to convert a Bytes
buffer to a Authority
.
This will try to prevent a copy if the type passed is the type used internally, and will copy the data if it is not.
sourcepub fn host(&self) -> &str
pub fn host(&self) -> &str
Get the host of this Authority
.
The host subcomponent of authority is identified by an IP literal encapsulated within square brackets, an IPv4 address in dotted- decimal form, or a registered name. The host subcomponent is case-insensitive.
abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
|---------|
|
host
§Examples
let authority: Authority = "example.org:80".parse().unwrap();
assert_eq!(authority.host(), "example.org");
sourcepub fn port(&self) -> Option<Port<&str>>
pub fn port(&self) -> Option<Port<&str>>
Get the port part of this Authority
.
The port subcomponent of authority is designated by an optional port
number following the host and delimited from it by a single colon (“:”)
character. It can be turned into a decimal port number with the as_u16
method or as a str
with the as_str
method.
abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
|-|
|
port
§Examples
Authority with port
let authority: Authority = "example.org:80".parse().unwrap();
let port = authority.port().unwrap();
assert_eq!(port.as_u16(), 80);
assert_eq!(port.as_str(), "80");
Authority without port
let authority: Authority = "example.org".parse().unwrap();
assert!(authority.port().is_none());
Trait Implementations§
source§impl FromStr for Authority
impl FromStr for Authority
§type Err = InvalidUri
type Err = InvalidUri
source§impl Hash for Authority
impl Hash for Authority
Case-insensitive hashing
§Examples
let a: Authority = "HELLO.com".parse().unwrap();
let b: Authority = "hello.coM".parse().unwrap();
let mut s = DefaultHasher::new();
a.hash(&mut s);
let a = s.finish();
let mut s = DefaultHasher::new();
b.hash(&mut s);
let b = s.finish();
assert_eq!(a, b);
source§impl<'a> PartialEq<&'a str> for Authority
impl<'a> PartialEq<&'a str> for Authority
source§impl<'a> PartialEq<Authority> for &'a str
impl<'a> PartialEq<Authority> for &'a str
source§impl PartialEq<Authority> for String
impl PartialEq<Authority> for String
source§impl PartialEq<Authority> for str
impl PartialEq<Authority> for str
source§impl PartialEq<String> for Authority
impl PartialEq<String> for Authority
source§impl PartialEq<str> for Authority
impl PartialEq<str> for Authority
Case-insensitive equality
§Examples
let authority: Authority = "HELLO.com".parse().unwrap();
assert_eq!(authority, "hello.coM");
assert_eq!("hello.com", authority);
source§impl PartialEq for Authority
impl PartialEq for Authority
source§impl<'a> PartialOrd<&'a str> for Authority
impl<'a> PartialOrd<&'a str> for Authority
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl<'a> PartialOrd<Authority> for &'a str
impl<'a> PartialOrd<Authority> for &'a str
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<Authority> for String
impl PartialOrd<Authority> for String
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<Authority> for str
impl PartialOrd<Authority> for str
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<String> for Authority
impl PartialOrd<String> for Authority
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd<str> for Authority
impl PartialOrd<str> for Authority
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl PartialOrd for Authority
impl PartialOrd for Authority
Case-insensitive ordering
§Examples
let authority: Authority = "DEF.com".parse().unwrap();
assert!(authority < "ghi.com");
assert!(authority > "abc.com");
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moreimpl Eq for Authority
Auto Trait Implementations§
impl !Freeze for Authority
impl RefUnwindSafe for Authority
impl Send for Authority
impl Sync for Authority
impl Unpin for Authority
impl UnwindSafe for Authority
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)