Struct domain::base::name::OwnedLabel

pub struct OwnedLabel(_);

An owned label.

Since labels are relatively short, this type doesn’t actually allocate any memory but is a 64 octet array.

Implementations

impl OwnedLabel

pub fn from_label(label: &Label) -> Self

Creates a new owned label from an existing label.

pub fn make_canonical(&mut self)

Converts the label into the canonical form.

This form has all octets representing ASCII letters converted to their lower case form.

pub fn as_label(&self) -> &Label

Returns a reference to the label.

pub fn as_label_mut(&mut self) -> &mut Label

Returns a mutable reference to the label.

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

Returns a slice that is the wire-representation of the label.

Methods from Deref<Target = Label>

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

Returns a reference to the underlying octets slice.

pub fn as_slice_mut(&mut self) -> &mut [u8]

Returns a mutable reference to the underlying octets slice.

pub fn to_canonical(&self) -> OwnedLabel

Returns the label in canonical form.

In this form, all ASCII letters are lowercase.

pub fn composed_cmp(&self, other: &Self) -> Ordering

Returns the composed label ordering.

pub fn lowercase_composed_cmp(&self, other: &Self) -> Ordering

Returns the composed ordering with ASCII letters lowercased.

pub fn build<Builder: OctetsBuilder>(
    &self,
    target: &mut Builder
) -> Result<(), ShortBuf>

Appends the label to an octets builder.

The method builds the encoded form of the label that starts with a one octet length indicator.

pub fn build_lowercase<Builder: OctetsBuilder>(
    &self,
    target: &mut Builder
) -> Result<(), ShortBuf>

Appends the lowercased label to an octets builder.

The method builds the encoded form of the label that starts with a one octet length indicator. It also converts all ASCII letters into their lowercase form.

pub fn is_root(&self) -> bool

Returns whether the label is the root label.

pub fn is_wildcard(&self) -> bool

Returns whether the label is the wildcard label.

pub fn compose_len(&self) -> usize

Returns the length of the composed version of the label.

This length is one more than the length of the label as their is a leading length octet.

Trait Implementations

impl AsMut<[u8]> for OwnedLabel

fn as_mut(&mut self) -> &mut [u8]

Performs the conversion.

impl AsMut<Label> for OwnedLabel

fn as_mut(&mut self) -> &mut Label

Performs the conversion.

impl AsRef<[u8]> for OwnedLabel

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

Performs the conversion.

impl AsRef<Label> for OwnedLabel

fn as_ref(&self) -> &Label

Performs the conversion.

impl Borrow<Label> for OwnedLabel

fn borrow(&self) -> &Label

Immutably borrows from an owned value.

impl BorrowMut<Label> for OwnedLabel

fn borrow_mut(&mut self) -> &mut Label

Mutably borrows from an owned value.

impl Deref for OwnedLabel

type Target = Label

The resulting type after dereferencing.

fn deref(&self) -> &Label

Dereferences the value.

impl DerefMut for OwnedLabel

fn deref_mut(&mut self) -> &mut Label

Mutably dereferences the value.

impl Eq for OwnedLabel

impl<'a> From<&'a Label> for OwnedLabel

fn from(label: &'a Label) -> Self

Performs the conversion.

impl Hash for OwnedLabel

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, 

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

impl Ord for OwnedLabel

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

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl<T: AsRef<Label>> PartialEq<T> for OwnedLabel

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: AsRef<Label>> PartialOrd<T> for OwnedLabel

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

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

#[must_use]fn lt(&self, other: &Rhs) -> bool

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

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]fn ge(&self, other: &Rhs) -> bool

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