Struct OwnedLabel

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

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 from_chars( chars: impl Iterator<Item = char>, ) -> Result<Self, LabelFromStrError>

Creates a label from a sequence of chars.

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 const MAX_LEN: usize = 63usize

pub fn iter(&self) -> Copied<Iter<'_, u8>>

Iterator over the octets of the 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 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 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 compose<Builder: OctetsBuilder + ?Sized>( &self, target: &mut Builder, ) -> Result<(), Builder::AppendError>

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 compose_canonical<Builder: OctetsBuilder + ?Sized>( &self, target: &mut Builder, ) -> Result<(), Builder::AppendError>

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 len(&self) -> usize

Returns the length of the label.

This length is that of the label’s content only. It will not contain the initial label length octet present in the wire format.

pub fn is_empty(&self) -> bool

Returns whether this is the empty label.

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) -> u16

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]

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

impl AsMut<Label> for OwnedLabel

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

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

impl AsRef<[u8]> for OwnedLabel

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

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

impl AsRef<Label> for OwnedLabel

fn as_ref(&self) -> &Label

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

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 Clone for OwnedLabel

fn clone(&self) -> OwnedLabel

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedLabel

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

Formats the value using the given formatter.

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 Display for OwnedLabel

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

impl FromStr for OwnedLabel

type Err = LabelFromStrError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

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, Self: Sized,

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.

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.

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

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

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.

impl Copy for OwnedLabel

impl Eq for OwnedLabel