Struct Chain

pub struct Chain<L, R> { /* private fields */ }

Two domain names chained together.

This type is the result of calling the chain method on RelativeDname, UncertainDname, or on Chain itself.

The chain can be both an absolute or relative domain name—and implements the respective traits ToDname or ToRelativeDname—, depending on whether the second name is absolute or relative.

A chain on an uncertain name is special in that the second name is only used if the uncertain name is relative.

Implementations

impl<L: ToRelativeDname, R: Compose> Chain<L, R>

pub fn chain<N: Compose>( self, other: N, ) -> Result<Chain<Self, N>, LongChainError>

Extends the chain with another domain name.

While the method accepts anything Compose as the second element of the chain, the resulting Chain will only implement ToDname or ToRelativeDname if if also implements ToDname or ToRelativeDname, respectively.

The method will fail with an error if the chained name is longer than 255 bytes.

impl<L, R> Chain<L, R>

pub fn unwrap(self) -> (L, R)

Unwraps the chain into its two constituent components.

Trait Implementations

impl<L: Clone, R: Clone> Clone for Chain<L, R>

fn clone(&self) -> Chain<L, R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<L: ToRelativeDname, R: Compose> Compose for Chain<L, R>

fn compose_len(&self) -> usize

Returns the number of bytes this value will need without compression.

fn compose<B: BufMut>(&self, buf: &mut B)

Appends the uncompressed representation of this value to buf.

impl<R: ToDname> Compose for Chain<UncertainDname, R>

fn compose_len(&self) -> usize

Returns the number of bytes this value will need without compression.

fn compose<B: BufMut>(&self, buf: &mut B)

Appends the uncompressed representation of this value to buf.

impl<L: ToRelativeDname, R: ToDname> Compress for Chain<L, R>

fn compress(&self, buf: &mut Compressor) -> Result<(), ShortBuf>

Appends the wire-format representation of the value to buf.

impl<R: ToDname> Compress for Chain<UncertainDname, R>

fn compress(&self, buf: &mut Compressor) -> Result<(), ShortBuf>

Appends the wire-format representation of the value to buf.

impl<L: Debug, R: Debug> Debug for Chain<L, R>

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

Formats the value using the given formatter.

impl<L: Display, R: Display> Display for Chain<L, R>

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

Formats the value using the given formatter.

impl<L: ToRelativeDname, R: ToDname> ToDname for Chain<L, R>

fn to_name(&self) -> Dname

Creates an uncompressed value of the domain name.

fn as_flat_slice(&self) -> Option<&[u8]>

Returns a byte slice of the content if possible.

fn name_eq<N: ToDname>(&self, other: &N) -> bool

Tests whether self and other are equal.

fn name_cmp<N: ToDname>(&self, other: &N) -> Ordering

Returns the ordering between self and other.

impl<R: ToDname> ToDname for Chain<UncertainDname, R>

fn to_name(&self) -> Dname

Creates an uncompressed value of the domain name.

fn as_flat_slice(&self) -> Option<&[u8]>

Returns a byte slice of the content if possible.

fn name_eq<N: ToDname>(&self, other: &N) -> bool

Tests whether self and other are equal.

fn name_cmp<N: ToDname>(&self, other: &N) -> Ordering

Returns the ordering between self and other.

impl<'a, L: ToRelativeDname, R: for<'r> ToLabelIter<'r>> ToLabelIter<'a> for Chain<L, R>

type LabelIter = ChainIter<'a, L, R>

The type of the iterator over the labels.

fn iter_labels(&'a self) -> Self::LabelIter

Returns an iterator over the labels.

fn starts_with<N: ToLabelIter<'a>>(&'a self, base: &'a N) -> bool

Determines whether base is a prefix of self.

fn ends_with<N: ToLabelIter<'a>>(&'a self, base: &'a N) -> bool

Determines whether base is a suffix of self.

impl<'a, R: ToDname> ToLabelIter<'a> for Chain<UncertainDname, R>

type LabelIter = UncertainChainIter<'a, R>

The type of the iterator over the labels.

fn iter_labels(&'a self) -> Self::LabelIter

Returns an iterator over the labels.

fn starts_with<N: ToLabelIter<'a>>(&'a self, base: &'a N) -> bool

Determines whether base is a prefix of self.

fn ends_with<N: ToLabelIter<'a>>(&'a self, base: &'a N) -> bool

Determines whether base is a suffix of self.

impl<L: ToRelativeDname, R: ToRelativeDname> ToRelativeDname for Chain<L, R>

fn to_name(&self) -> RelativeDname

Creates an uncompressed value of the domain name.

fn as_flat_slice(&self) -> Option<&[u8]>

Returns a byte slice of the content if possible.

fn chain<N: Compose>(self, suffix: N) -> Result<Chain<Self, N>, LongChainError>

where Self: Sized,

Returns a chain of this name and the provided absolute name.

fn chain_root(self) -> Chain<Self, Dname>

where Self: Sized,

Returns the absolute name by chaining it with the root label.

fn name_eq<N: ToRelativeDname>(&self, other: &N) -> bool

Tests whether self and other are equal.

fn name_cmp<N: ToRelativeDname>(&self, other: &N) -> Ordering

Returns the ordering between self and other.