Struct Name 

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

Owned, canonical DNS name (lowercased on construction).

Implementations

impl Name

pub fn as_str(&self) -> &str

Available on crate features alloc or no-atomic or std only.

Returns the canonical lowercase form of this name.

pub fn len(&self) -> usize

Available on crate features alloc or no-atomic or std only.

Returns the length in bytes.

pub fn is_empty(&self) -> bool

Available on crate features alloc or no-atomic or std only.

Returns true if this name is empty.

impl Name

pub fn try_from_str(s: &str) -> Result<Name, NameError>

Constructs a Name from a string, validating label lengths and total length, normalizing to canonical lowercase.

pub fn from_wire_labels<'a, E, I>(labels: I) -> Option<Name>

where I: IntoIterator<Item = Result<&'a [u8], E>>,

Builds a canonical Name directly from a sequence of raw wire labels (each the decompressed bytes of one DNS label, no length prefix), joining them with . plus a trailing .. Labels are ASCII case-folded (RFC 4343); non-ASCII bytes are preserved, and the assembled name must be valid UTF-8 — DNS-SD names are UTF-8 (RFC 6763 §4.1). Returns None on a malformed label (Err item), a label containing the . separator byte, non-UTF-8 bytes, or a label/total length violation.

This is the wire-decode counterpart to Name::try_from_str: it skips the throwaway presentation String a caller would otherwise assemble and — unlike a byte as char join — never Latin-1-reinterprets a multi-byte UTF-8 sequence into mojibake.

Length limits are checked incrementally, before each label is decoded or pushed, so an oversized iterator is rejected without unbounded allocation.

Trait Implementations

impl Clone for Name

fn clone(&self) -> Name

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Name

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

Formats the value using the given formatter.

impl Display for Name

Available on crate features alloc or no-atomic or std only.

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

Formats the value using the given formatter.

impl Eq for Name

impl Hash for Name

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 PartialEq for Name

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