Struct DnsName 

pub struct DnsName {
    pub labels: Vec<String>,
}

A DNS domain name consisting of labels.

Supports encoding/decoding with RFC 1035 compression pointers.

Fields

labels: Vec<String>

The labels making up the domain name (e.g., [“www”, “example”, “com”]).

Implementations

impl DnsName

pub fn new(labels: Vec<String>) -> Self

Create a new DnsName from labels.

pub fn root() -> Self

Create a root name (empty labels).

pub fn from_str_dotted(s: &str) -> Result<Self, FieldError>

Parse a DNS name from a dot-separated string. “www.example.com” → labels: [“www”, “example”, “com”] “www.example.com.” → same (trailing dot is ignored)

pub fn is_root(&self) -> bool

Check if this is the root name.

pub fn to_fqdn(&self) -> String

Get the fully qualified domain name string. Returns “www.example.com.” with trailing dot.

pub fn encode(&self) -> Vec<u8>

Encode to wire format without compression. Each label is preceded by its length byte, terminated by a zero byte.

pub fn encode_compressed( &self, current_offset: usize, compression_map: &mut HashMap<String, u16>, ) -> Vec<u8>

Encode to wire format with compression. Uses compression_map to track previously written name positions. current_offset is where this name will be written in the packet.

pub fn decode(packet: &[u8], offset: usize) -> Result<(Self, usize), FieldError>

Decode a DNS name from wire format with pointer decompression.

packet is the full packet buffer (needed for pointer resolution). offset is the starting position of the name.

Returns the decoded name and the number of bytes consumed from offset (not counting bytes reached via pointers).

pub fn wire_len(&self) -> usize

Wire-format length of this name without compression.

Trait Implementations

impl Clone for DnsName

fn clone(&self) -> DnsName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DnsName

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

Formats the value using the given formatter.

impl Default for DnsName

fn default() -> DnsName

Returns the “default value” for a type.

impl Display for DnsName

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

Formats the value using the given formatter.

impl From<&str> for DnsName

fn from(s: &str) -> Self

Converts to this type from the input type.

impl Hash for DnsName

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

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

impl StructuralPartialEq for DnsName