Struct Name 

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

Available on crate features dns and std only.

A fully qualified DNS name in uncompressed wire format.

Unlike Domain, this type preserves DNS label boundaries and arbitrary label octets, including their original case, and it can represent the root name. Equality, hashing, and ordering are ASCII-case-insensitive. Ordering is not RFC 4034 DNSSEC canonical-name ordering.

Implementations

impl Name

pub const MAX_WIRE_LEN: usize = 255

Maximum encoded length of a DNS name, including the root label.

pub fn root() -> Name

Return the DNS root name (.).

pub fn from_wire(wire: &[u8]) -> Result<Name, NameParseError>

Parse one complete, uncompressed DNS name.

Compression pointers are invalid here. RFC 9460 requires the target name in SVCB-compatible RDATA to be uncompressed.

pub fn from_wire_bytes(wire: &Bytes) -> Result<Name, NameParseError>

Parse one complete, uncompressed DNS name from shared bytes.

Compression pointers are invalid here. The returned name shares the input allocation.

pub fn from_message( message: &[u8], offset: usize, ) -> Result<(Name, usize), NameParseError>

Parse a possibly compressed DNS name at offset in a complete message.

The returned length is the number of message octets occupied by the encoded name at offset; bytes followed through compression pointers are not included. RFC 1035 compression pointers must refer to prior name occurrences. Enforcing a decreasing target ceiling guarantees termination without rejecting long valid chains.

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

Return this name’s case-preserving, uncompressed wire representation.

pub fn is_root(&self) -> bool

Return whether this is the DNS root name (.).

pub fn to_domain(&self) -> Option<Domain>

Convert this wire name to Rama’s presentation-domain type.

The root name and names with label octets that Domain cannot represent return None. Conversion allocates one presentation buffer because the wire and presentation encodings differ.

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

Formats a human-readable diagnostic, not DNS master-file syntax.

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

Formats the value using the given formatter.

impl DnsCnameResolver for Name

type Error = !

Error returned by this resolver.

fn lookup_cname( &self, _: Domain, ) -> impl Stream<Item = Result<Name, <Name as DnsCnameResolver>::Error>> + Send

Resolve CNAME targets for the given domain.

fn into_box_dns_cname_resolver(self) -> BoxDnsCnameResolver

Box this resolver to allow dynamic dispatch.

impl Eq for Name

impl From<&Domain> for Name

fn from(domain: &Domain) -> Name

Converts to this type from the input type.

impl From<Domain> for Name

fn from(domain: Domain) -> Name

Converts to this type from the input type.

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

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

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Name

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Name

fn partial_cmp(&self, other: &Name) -> 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.