Struct fluent_uri::Authority

#[repr(transparent)]
pub struct Authority<T: Storage> { /* private fields */ }

The authority component of URI reference.

Implementations

impl<'i, 'o, T: Io<'i, 'o>> Authority<T>

pub fn as_str(&'i self) -> &'o str

Returns the authority as a string slice.

Panics

Panics if the host subcomponent is already taken.

Examples

use fluent_uri::Uri;

let uri = Uri::parse("ftp://user@[fe80::abcd]:6780/")?;
let authority = uri.authority().unwrap();
assert_eq!(authority.as_str(), "user@[fe80::abcd]:6780");

pub fn userinfo(&'i self) -> Option<&'o EStr>

Returns the userinfo subcomponent.

Examples

use fluent_uri::Uri;

let uri = Uri::parse("ftp://user@192.168.1.24/")?;
let authority = uri.authority().unwrap();
assert_eq!(authority.userinfo().unwrap(), "user");

pub fn host(&self) -> &Host<T>

Returns the host subcomponent.

Panics

Panics if the host subcomponent is already taken.

pub fn port(&'i self) -> Option<&'o str>

Returns the port subcomponent.

Note that in the generic URI syntax, the port may be empty, with leading zeros, or very large. It is up to you to decide whether to deny such a port, fallback to the scheme’s default if it is empty, ignore the leading zeros, or use a different addressing mechanism that allows a large port.

Examples

use fluent_uri::Uri;

let uri = Uri::parse("ssh://device.local:4673/")?;
let authority = uri.authority().unwrap();
assert_eq!(authority.port(), Some("4673"));

let uri = Uri::parse("ssh://device.local:/")?;
let authority = uri.authority().unwrap();
assert_eq!(authority.port(), Some(""));

let uri = Uri::parse("ssh://device.local/")?;
let authority = uri.authority().unwrap();
assert_eq!(authority.port(), None);

Trait Implementations

impl Debug for Authority<&mut [u8]>

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

Formats the value using the given formatter.

impl Debug for Authority<&str>

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

Formats the value using the given formatter.

impl Debug for Authority<String>

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

Formats the value using the given formatter.

impl Display for Authority<&str>

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

Formats the value using the given formatter.

impl Display for Authority<String>

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

Formats the value using the given formatter.