Struct Label

pub struct Label<'a> { /* private fields */ }

Represents a label in a domain name

A valid label is consists of A-Z, a-z, 0-9, and hyphen (-), and must be at most 63 characters in length. This library also considers valid any label starting with underscore (_), to be able to parse mDNS domain names.

Microsoft implementation allows unicode characters in the label content. To create a label with unicode characters, use Label::new_unchecked

The Display implementation uses std::string::String::from_utf8_lossy to display the label.

Implementations

impl<'a> Label<'a>

pub fn new<T: Into<Cow<'a, [u8]>>>(data: T) -> Result<Self>

Create a new Label if given data is valid and within the limits

pub fn new_unchecked<T: Into<Cow<'a, [u8]>>>(data: T) -> Self

Create a new Label without checking for size limits or valid content. This function can be used to create labels with unicode characters

pub fn len(&self) -> usize

Returns the length of the label

pub fn is_empty(&self) -> bool

Returns true if the label is empty

pub fn into_owned<'b>(self) -> Label<'b>

Transforms the inner data into its owned type

pub fn is_valid(&self) -> bool

Returns true if the label is valid.

Trait Implementations

impl AsRef<[u8]> for Label<'_>

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

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

impl<'a> Clone for Label<'a>

fn clone(&self) -> Label<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Label<'_>

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

Formats the value using the given formatter.

impl Display for Label<'_>

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

Formats the value using the given formatter.

impl<'a> Hash for Label<'a>

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<'a> PartialEq for Label<'a>

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

impl<'a> StructuralPartialEq for Label<'a>