Struct rhymuri::Authority

pub struct Authority { /* fields omitted */ }

This is the optional part of a URI which governs the URI’s namespace. It typically contains a host name or IP address, and may also include a port number and/or userinfo component.

Examples

Parsing an Authority into its components

use rhymuri::Authority;

let authority = Authority::parse("nobody@www.example.com:8080")?;
assert_eq!(Some("nobody".as_bytes()), authority.userinfo());
assert_eq!("www.example.com".as_bytes(), authority.host());
assert_eq!(Some(8080), authority.port());

Generating a URI from its components

use rhymuri::Authority;

let mut authority = Authority::default();
authority.set_userinfo(Some("nobody").map(Into::into));
authority.set_host("www.example.com");
authority.set_port(Some(8080));
assert_eq!("nobody@www.example.com:8080", authority.to_string());

Implementations

impl Authority

#[must_use = "why u no use host return value?"]pub fn host(&self) -> &[u8]

Borrow the host name part of the Authority.

#[must_use = "why did you get the port number and then throw it away?"]pub fn port(&self) -> Option<u16>

Borrow the port number part of the Authority.

pub fn set_userinfo<T>(&mut self, userinfo: T) where
    T: Into<Option<Vec<u8>>>, 

Change the userinfo part of the Authority.

pub fn set_host<T>(&mut self, host: T) where
    T: Into<Vec<u8>>, 

Change the host name part of the Authority.

pub fn set_port(&mut self, port: Option<u16>)

Change the port number part of the Authority.

#[must_use = "security breach... security breach... userinfo not used"]pub fn userinfo(&self) -> Option<&[u8]>

Borrow the userinfo part of the Authority.

#[must_use = "you parsed it; don't you want the results?"]pub fn parse<T>(authority_string: T) -> Result<Self, Error> where
    T: AsRef<str>, 

Interpret the given string as the Authority component of a URI, separating its various subcomponents, returning an Authority value containing them.

Errors

There are many ways to screw up the Authority part of URI string, and this function will let you know what’s up by returning a variant of the Error type.

Trait Implementations

impl Clone for Authority

fn clone(&self) -> Authority

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Authority

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

Formats the value using the given formatter.

impl Default for Authority

fn default() -> Authority

Returns the “default value” for a type.

impl Display for Authority

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

Formats the value using the given formatter.

impl PartialEq<Authority> for Authority

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Authority