Struct trust_dns::rr::Label

pub struct Label(_);

Labels are always stored as ASCII, unicode characters must be encoded with punycode

Methods

impl Label

pub fn from_raw_bytes(bytes: &[u8]) -> Result<Label, ProtoError>

These must only be ASCII, with unicode encoded to PunyCode, or other such transformation.

This uses the bytes as raw ascii values, with nothing escaped on the wire. Generally users should use from_str or from_ascii

pub fn from_utf8(s: &str) -> Result<Label, ProtoError>

Translates this string into IDNA safe name, encoding to punycode as necessary.

pub fn from_ascii(s: &str) -> Result<Label, ProtoError>

Takes the ascii string and returns a new label.

This will return an Error if the label is not an ascii string

pub fn to_lowercase(&self) -> Label

Converts this label to lowercase

pub fn is_wildcard(&self) -> bool

Returns true if this label is the wildcard, '*', label

pub fn len(&self) -> usize

Returns the lenght in bytes of this label

pub fn is_empty(&self) -> bool

True if the label contains no characters

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

Returns the raw bytes of the label, this is good for writing to the wire.

See [Display] for presentation version (unescaped from punycode, etc)

pub fn eq_ignore_ascii_case(&self, other: &Label) -> bool

Performs the equivelence operation disregarding case

pub fn cmp_with_f<F>(&self, other: &Label) -> Ordering where
    F: LabelCmp, 

compares with the other label, ignoring case

pub fn to_utf8(&self) -> String

Performs the conversion to utf8 from IDNA as necessary, see fmt for more details

pub fn to_ascii(&self) -> String

Converts this label to safe ascii, escaping characters as necessary

If this is an IDNA, punycode, label, then the xn-- prefix will be maintained as ascii

pub fn write_ascii<W>(&self, f: &mut W) -> Result<(), Error> where
    W: Write, 

Writes this label to safe ascii, escaping characters as necessary

Trait Implementations

impl Clone for Label

fn clone(&self) -> Label

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> IntoLabel for &'a Label

fn into_label(self) -> Result<Label, ProtoError>

Convert this into Label

impl IntoLabel for Label

fn into_label(self) -> Result<Label, ProtoError>

Convert this into Label

impl Hash for Label

fn hash<H>(&self, state: &mut H) where
    H: Hasher, 

Feeds this value into the given [Hasher].

default fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl PartialEq<Label> for Label

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

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

This method tests for !=.

impl Ord for Label

fn cmp(&self, other: &Label) -> Ordering

This method returns an Ordering between self and other.

default fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

default fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

default fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl AsRef<[u8]> for Label

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

Performs the conversion.

impl Eq for Label

impl PartialOrd<Label> for Label

fn partial_cmp(&self, other: &Label) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Display for Label

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

outputs characters in a safe string manner.

if the string is punycode, i.e. starts with xn--, otherwise it translates to a safe ascii string escaping characters as necessary.

impl Borrow<[u8]> for Label

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

Immutably borrows from an owned value.

impl Debug for Label

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

Formats the value using the given formatter.