Struct iref_core::uri::HostBuf

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

Owned URI host.

Implementations

impl HostBuf

pub fn new(input: Vec<u8>) -> Result<Self, InvalidHost<Vec<u8>>>

Creates a new owned URI host by parsing the input value

pub const unsafe fn new_unchecked(input: Vec<u8>) -> Self

Creates a new owned URI host from the input value without validation.

Safety

The input data must be a valid URI host.

pub fn as_host(&self) -> &Host

impl HostBuf

pub fn into_string(self) -> String

impl HostBuf

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

pub fn into_bytes(self) -> Vec<u8>

impl HostBuf

pub fn into_pct_string(self) -> PctString

Methods from Deref<Target = Host>

pub const EMPTY: &'static Self = _

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

pub fn as_str(&self) -> &str

pub fn as_pct_str(&self) -> &PctStr

Returns the host as a percent-encoded string slice.

Methods from Deref<Target = PctStr>

pub fn len(&self) -> usize

Length of the decoded string (character count).

Computed in linear time. This is different from the byte length, which can be retrieved using value.as_bytes().len().

pub fn is_empty(&self) -> bool

Checks if the string is empty.

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

Returns the underlying percent-encoding bytes.

pub fn as_str(&self) -> &str

Get the underlying percent-encoded string slice.

pub fn chars(&self) -> Chars<'_>

Iterate over the encoded characters of the string.

pub fn bytes(&self) -> Bytes<'_>

Iterate over the encoded bytes of the string.

pub fn decode(&self) -> String

Decoding.

Return the string with the percent-encoded characters decoded.

Trait Implementations

impl AsRef<[u8]> for HostBuf

fn as_ref(&self) -> &[u8]

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

impl AsRef<Host> for HostBuf

fn as_ref(&self) -> &Host

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

impl AsRef<str> for HostBuf

fn as_ref(&self) -> &str

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

impl Borrow<[u8]> for HostBuf

fn borrow(&self) -> &[u8]

Immutably borrows from an owned value.

impl Borrow<Host> for HostBuf

fn borrow(&self) -> &Host

Immutably borrows from an owned value.

impl Clone for HostBuf

fn clone(&self) -> HostBuf

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HostBuf

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

Formats the value using the given formatter.

impl Default for HostBuf

fn default() -> Self

Returns the “default value” for a type.

impl Deref for HostBuf

type Target = Host

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for HostBuf

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

Formats the value using the given formatter.

impl From<HostBuf> for String

fn from(value: HostBuf) -> String

Converts to this type from the input type.

impl From<HostBuf> for Vec<u8>

fn from(value: HostBuf) -> Vec<u8>

Converts to this type from the input type.

impl FromStr for HostBuf

type Err = InvalidHost<String>

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, InvalidHost<String>>

Parses a string s to return a value of this type.

impl Hash for HostBuf

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

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 HostBuf

fn cmp(&self, other: &Self) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl<'a> PartialEq<&'a Host> for HostBuf

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

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

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

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

impl PartialEq<Host> for HostBuf

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

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

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

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

impl PartialEq for HostBuf

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

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

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

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

impl<'a> PartialOrd<&'a Host> for HostBuf

fn partial_cmp(&self, other: &&'a Host) -> Option<Ordering>

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<Host> for HostBuf

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd for HostBuf

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl TryFrom<String> for HostBuf

type Error = InvalidHost<String>

The type returned in the event of a conversion error.

fn try_from(input: String) -> Result<HostBuf, InvalidHost<String>>

Performs the conversion.

impl TryFrom<Vec<u8>> for HostBuf

type Error = InvalidHost<Vec<u8>>

The type returned in the event of a conversion error.

fn try_from(input: Vec<u8>) -> Result<HostBuf, InvalidHost<Vec<u8>>>

Performs the conversion.

impl Eq for HostBuf