Struct Hostname 

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

A validated hostname.

This type ensures the hostname conforms to RFC 1035 and RFC 1123:

• Total length is at most 253 characters
• Each label (part between dots) is at most 63 characters
• Labels contain only ASCII letters, digits, and hyphens
• Labels do not start or end with a hyphen
• No empty labels (no consecutive dots, leading dots, or trailing dots)

Implementations

impl Hostname

pub fn new(hostname: impl Into<String>) -> Result<Self, Error>

Create a new hostname, validating it according to RFC 1035/1123.

pub fn as_str(&self) -> &str

Returns the hostname as a string slice.

pub fn into_string(self) -> String

Consumes the hostname and returns the underlying String.

Trait Implementations

impl AsRef<str> for Hostname

fn as_ref(&self) -> &str

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

impl Clone for Hostname

fn clone(&self) -> Hostname

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hostname

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

Formats the value using the given formatter.

impl Display for Hostname

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

Formats the value using the given formatter.

impl EncodeSize for Hostname

fn encode_size(&self) -> usize

Returns the encoded size of this value (in bytes).

impl Hash for Hostname

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 Hostname

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

fn eq(&self, other: &Hostname) -> 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 Hostname

fn partial_cmp(&self, other: &Hostname) -> 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 Read for Hostname

type Cfg = ()

The Cfg type parameter allows passing configuration during the read process. This is crucial for safely decoding untrusted data, for example, by providing size limits for collections or strings.

fn read_cfg(buf: &mut impl Buf, _: &()) -> Result<Self, CodecError>

Reads a value from the buffer using the provided configuration cfg.

impl TryFrom<&str> for Hostname

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for Hostname

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Write for Hostname

fn write(&self, buf: &mut impl BufMut)

Writes the binary representation of self to the provided buffer buf.

impl Eq for Hostname

impl StructuralPartialEq for Hostname