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 Hash for Authority
Case-insensitive hashing
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 PartialEq<str> for Authority
Case-insensitive equality
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<'a> PartialOrd<&'a str> for Authority
impl<'a> PartialOrd<&'a str> for Authority
Source§impl<'a> PartialOrd<Authority> for &'a str
impl<'a> PartialOrd<Authority> for &'a str
Source§impl PartialOrd<Authority> for String
impl PartialOrd<Authority> for String
Source§impl PartialOrd<Authority> for str
impl PartialOrd<Authority> for str
Source§impl PartialOrd<String> for Authority
impl PartialOrd<String> for Authority
Source§impl PartialOrd<str> for Authority
impl PartialOrd<str> for Authority
Source§impl PartialOrd for Authority
Case-insensitive ordering
impl PartialOrd for Authority
Case-insensitive ordering
§Examples
let authority: Authority = "DEF.com".parse().unwrap();
assert!(authority < "ghi.com");
assert!(authority > "abc.com");