Struct Label

pub struct Label(String);

A domain name label, stored in lowercase in its ASCII-encoded form

Tuple Fields

0: String

Implementations

impl Label

pub(crate) fn new_ace(label: String) -> Result<Self, ParseError>

Create a new Label from the given ACE input, checking if all characters in the label are valid, and that the length is appropriate. This function does not do any conversions, it only checks the input for ASCII validity. The validity of A-labels is not checked and fake A-labels (labels starting with “xn–”, while not being valid punycode) are accepted.

Errors

This function returns a ParseError if parsing of the label fails

pub(crate) fn new_idn(label: &str) -> Result<Self, ParseError>

Create a new Label from the given possibly-internationalized input label, parsing and encoding the input into an A-label if necessary. If the input contains a fake A-label, ParseError::Idna is returned.

Errors

This function returns a ParseError if parsing of the label fails

pub fn as_str(&self) -> &str

Get the internal string representing this label

The returned value is an ASCII lowercase string, with non-ASCII characters encoded using punycode. The string does not contain any .s. It may however be a “fake A-label”, i.e. start with “xn–”, but not be valid punycode.

Example

let domain = Domain::presented("παράδειγμα.EXAMPLE.com")?;
for label in domain.labels() {
	assert!(label.as_str().is_ascii());
	assert!(label
		.as_str()
		.chars()
		.all(|c| c.is_ascii_lowercase() || c.is_ascii_digit() || c == '-'));
}

Trait Implementations

impl AsRef<str> for Label

fn as_ref(&self) -> &str

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

impl Clone for Label

fn clone(&self) -> Label

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, fmt: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl Hash for Label

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 Label

fn cmp(&self, other: &Label) -> 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 PartialEq for Label

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

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

impl StructuralPartialEq for Label