Struct Authority 

pub struct Authority(/* private fields */);

URL authority: [userinfo "@"] host [":" port].

Implementations

impl Authority

pub const fn as_str(&self) -> &str

Returns the component as a string slice.

impl Authority

pub fn new(src: &str) -> Result<&Authority, InvalidUrl>

Strictly validates an authority.

use urly::{Authority, ErrorKind};

let auth = Authority::new("user:[email protected]:8080").unwrap();
assert_eq!(auth.host(), "example.com");
assert_eq!(auth.port_u16(), Some(8080));
assert_eq!(auth.userinfo().unwrap().password(), Some("pw"));

let err = Authority::new("example.com:99999").unwrap_err();
assert_eq!(err.kind(), ErrorKind::PortOutOfRange);

pub fn from_static(src: &'static str) -> &'static Authority

Converts a static string to an authority.

Panics

Panics if the authority is not valid.

pub fn userinfo(&self) -> Option<&UserInfo>

Returns the userinfo, if present.

pub fn host(&self) -> &str

Returns the host. IPv6 addresses include the brackets.

pub fn port(&self) -> Option<Port<&str>>

Returns the port, if present.

pub fn port_u16(&self) -> Option<u16>

Returns the port as a number, if present.

pub fn host_port(&self) -> &str

Returns the authority without the userinfo.

use urly::Authority;

let auth = Authority::new("user:[email protected]:8080").unwrap();
assert_eq!(auth.host_port(), "example.com:8080");

Trait Implementations

impl AsRef<str> for Authority

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for Authority

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Authority

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Authority

impl Hash for Authority

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

impl Ord for Authority

fn cmp(&self, other: &Authority) -> Ordering

This method returns an Ordering between self and other.

impl PartialEq for Authority

fn eq(&self, other: &Authority) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<&str> for Authority

fn eq(&self, other: &&str) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<Authority> for str

fn eq(&self, other: &Authority) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<Authority> for &str

fn eq(&self, other: &Authority) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<str> for Authority

fn eq(&self, other: &str) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Authority

fn partial_cmp(&self, other: &Authority) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> TryFrom<&'a str> for &'a Authority

type Error = InvalidUrl

The type returned in the event of a conversion error.

fn try_from(s: &'a str) -> Result<Self, Self::Error>

Performs the conversion.