Struct AbsoluteUriRef 

pub struct AbsoluteUriRef<'a> { /* private fields */ }

Available on crate feature net only.

Borrowed, allocation-free view of a strict absolute URI.

This is the non-retaining counterpart to Uri::parse_strict. It uses the same parser and exposes its already-scanned components without copying the input. Protocol codecs can therefore apply their own URI-shape policy without reparsing delimiters or taking ownership of a receive buffer.

Debug redacts the password portion of userinfo. Display preserves the complete wire spelling and may therefore expose credentials.

Implementations

impl<'a> AbsoluteUriRef<'a>

pub fn parse_strict(bytes: &'a [u8]) -> Result<AbsoluteUriRef<'a>, ParseError>

Parse a borrowed absolute URI using strict RFC 3986 syntax.

pub const fn as_bytes(self) -> &'a [u8]

Return the complete URI bytes.

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

Return the complete URI string.

pub fn scheme(self) -> &'a str

Return the scheme without its trailing colon.

pub fn authority(self) -> Option<&'a str>

Return the raw authority without the leading //, when present.

pub fn authority_ref(self) -> Option<AuthorityRef<'a>>

Return the typed, already-scanned authority, when present.

Unlike authority, this exposes typed host, userinfo, and port components. It remains allocation-free and does not rescan the authority grammar. Domain and reg-name views borrow the source directly; a parser-validated numeric IP literal is materialized from its preserved spelling on demand. An RFC-valid empty URI authority is preserved and can therefore contain an empty host.

pub fn userinfo(self) -> Option<&'a str>

Return the userinfo without its trailing @, when present.

pub fn host(self) -> Option<&'a str>

Return the host spelling, when an authority is present.

Brackets around an IP literal are retained. An RFC-valid empty host is returned as Some(""), allowing protocol policy to reject it.

pub const fn port(self) -> OptPort

Return the explicit port state from the authority.

pub fn path(self) -> PathRef<'a>

Return the borrowed path component.

pub fn path_str(self) -> &'a str

Return the strict wire spelling of the path component.

pub fn query(self) -> Option<QueryRef<'a>>

Return the query without its leading ?, when present.

pub fn fragment(self) -> Option<FragmentRef<'a>>

Return the fragment without its leading #, when present.

Trait Implementations

impl<'a> Clone for AbsoluteUriRef<'a>

fn clone(&self) -> AbsoluteUriRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for AbsoluteUriRef<'a>

impl Debug for AbsoluteUriRef<'_>

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

Formats the value using the given formatter.

impl Display for AbsoluteUriRef<'_>

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

Formats the value using the given formatter.

impl<'a> Eq for AbsoluteUriRef<'a>

impl<'a> PartialEq for AbsoluteUriRef<'a>

fn eq(&self, other: &AbsoluteUriRef<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for AbsoluteUriRef<'a>

impl<'a> TryFrom<&'a [u8]> for AbsoluteUriRef<'a>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( value: &'a [u8], ) -> Result<AbsoluteUriRef<'a>, <AbsoluteUriRef<'a> as TryFrom<&'a [u8]>>::Error>

Performs the conversion.

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

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( value: &'a str, ) -> Result<AbsoluteUriRef<'a>, <AbsoluteUriRef<'a> as TryFrom<&'a str>>::Error>

Performs the conversion.