Struct UninterpretedHostRef 

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

Available on crate feature net only.

Borrowed view of an UninterpretedHost — a wide, Copy pointer into pre-validated bytes plus the bracketed flag. Mirrors DomainRef’s relationship to Domain.

All inspection / conversion operations available on UninterpretedHost are also available here, so callers holding a HostRef don’t need to round-trip back through an owned form just to pct-decode or attempt a typed conversion.

Equality, hashing, and ordering follow the same ASCII-case-insensitive rules as UninterpretedHost.

Implementations

impl<'a> UninterpretedHostRef<'a>

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

Raw on-the-wire bytes — not pct-decoded. Brackets (for IP-literals) are not included.

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

Raw bytes view.

pub fn is_bracketed(&self) -> bool

true when this came from a bracketed IP-literal ([vN.X]).

pub fn as_unicode(&self) -> Cow<'a, str>

Pct-decoded view. Borrows when no % is present, allocates a new String when decoding actually occurred. See UninterpretedHost::as_unicode for the full contract.

If the decoded bytes aren’t valid UTF-8 (e.g. an isolated pct-encoded byte that doesn’t form a multi-byte sequence), falls back to lossy U+FFFD substitution — matching the crate::uri::Query::as_decoded_str / crate::uri::Fragment::as_decoded_str contract so callers see consistent behaviour across decoded-view surfaces.

pub fn into_owned(self) -> UninterpretedHost

Returns an owned UninterpretedHost by copying the underlying bytes. Named into_owned (matching std::borrow::Cow::into_owned) so it doesn’t shadow the std ToOwned trait method.

Trait Implementations

impl<'a> Clone for UninterpretedHostRef<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for UninterpretedHostRef<'a>

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

Formats the value using the given formatter.

impl Display for UninterpretedHostRef<'_>

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

Formats the value using the given formatter.

impl<'a> From<&'a UninterpretedHost> for UninterpretedHostRef<'a>

fn from(host: &'a UninterpretedHost) -> UninterpretedHostRef<'a>

Converts to this type from the input type.

impl Hash for UninterpretedHostRef<'_>

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

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for UninterpretedHostRef<'_>

fn cmp(&self, other: &UninterpretedHostRef<'_>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for UninterpretedHostRef<'_>

fn eq(&self, other: &UninterpretedHostRef<'_>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for UninterpretedHostRef<'_>

fn partial_cmp(&self, other: &UninterpretedHostRef<'_>) -> 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<UninterpretedHostRef<'a>> for Domain

fn try_from( host: UninterpretedHostRef<'a>, ) -> Result<Domain, <Domain as TryFrom<UninterpretedHostRef<'a>>>::Error>

Pct-decodes the bytes and, with the idna feature, applies UTS #46 normalization to ACE. Returns a DomainParseError tagged with the “bracketed IP-literal” kind for bracketed inputs — IP-literals are a different grammatical category and have no domain interpretation.

type Error = DomainParseError

The type returned in the event of a conversion error.

impl<'a> TryFrom<UninterpretedHostRef<'a>> for IpAddr

fn try_from( host: UninterpretedHostRef<'a>, ) -> Result<IpAddr, <IpAddr as TryFrom<UninterpretedHostRef<'a>>>::Error>

Pct-decodes the bytes and parses as an IPv4 or IPv6 address. Bracketed IPvFuture inputs always fail here — no vN form is registered with IANA, so there’s nothing to decode.

type Error = AddrParseError

The type returned in the event of a conversion error.

impl<'a> TryFrom<UninterpretedHostRef<'a>> for Ipv4Addr

type Error = AddrParseError

The type returned in the event of a conversion error.

fn try_from( host: UninterpretedHostRef<'a>, ) -> Result<Ipv4Addr, <Ipv4Addr as TryFrom<UninterpretedHostRef<'a>>>::Error>

Performs the conversion.

impl<'a> TryFrom<UninterpretedHostRef<'a>> for Ipv6Addr

type Error = AddrParseError

The type returned in the event of a conversion error.

fn try_from( host: UninterpretedHostRef<'a>, ) -> Result<Ipv6Addr, <Ipv6Addr as TryFrom<UninterpretedHostRef<'a>>>::Error>

Performs the conversion.

impl<'a> Copy for UninterpretedHostRef<'a>

impl Eq for UninterpretedHostRef<'_>