Struct domain::rdata::rfc1035::Txt

pub struct Txt<Octets>(_);

Txt record data.

Txt records hold descriptive text.

The Txt record type is defined in RFC 1035, section 3.3.14.

Implementations

impl<Octets: FromBuilder> Txt<Octets>

pub fn from_slice(text: &[u8]) -> Result<Self, ShortBuf> where
    <Octets as FromBuilder>::Builder: EmptyBuilder, 

Creates a new Txt record from a single character string.

impl<Octets: AsRef<[u8]>> Txt<Octets>

pub fn iter(&self) -> TxtIter

Returns an iterator over the text items.

The Txt format contains one or more length-delimited byte strings. This method returns an iterator over each of them.

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

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn text<T: FromBuilder>(&self) -> Result<T, ShortBuf> where
    <T as FromBuilder>::Builder: EmptyBuilder, 

Returns the text content.

If the data is only one single character string, returns a simple clone of the slice with the data. If there are several character strings, their content will be copied together into one single, newly allocated bytes value.

Access to the individual character strings is possible via iteration.

Trait Implementations

impl<Octets, Other> CanonicalOrd<Txt<Other>> for Txt<Octets> where
    Octets: AsRef<[u8]>,
    Other: AsRef<[u8]>, 

fn canonical_cmp(&self, other: &Txt<Other>) -> Ordering

Returns the canonical ordering between self and other.

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

Returns whether self is canonically less than other.

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

Returns whether self is canonically less than or equal to other.

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

Returns whether self is canonically greater than other.

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

Returns whether self is canonically greater than or equal to other.

impl<Octets: Clone> Clone for Txt<Octets>

fn clone(&self) -> Txt<Octets>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octets: AsRef<[u8]>> Compose for Txt<Octets>

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

Appends the concrete representation of the value to the target.

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

Appends the canonical representation of the value to the target.

impl<Octets: AsRef<[u8]>> Debug for Txt<Octets>

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

Formats the value using the given formatter.

impl<Octets: AsRef<[u8]>> Display for Txt<Octets>

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

Formats the value using the given formatter.

impl<Octets: AsRef<[u8]>> Eq for Txt<Octets>

impl<O, N> From<Txt<O>> for MasterRecordData<O, N>

fn from(value: Txt<O>) -> Self

Performs the conversion.

impl<O, N> From<Txt<O>> for AllRecordData<O, N>

fn from(value: Txt<O>) -> Self

Performs the conversion.

impl<Octets: AsRef<[u8]>> Hash for Txt<Octets>

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<'a, Octets: AsRef<[u8]>> IntoIterator for &'a Txt<Octets>

type Item = &'a [u8]

The type of the elements being iterated over.

type IntoIter = TxtIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Octets: AsRef<[u8]>> Ord for Txt<Octets>

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<Ref: OctetsRef> Parse<Ref> for Txt<Ref::Range>

fn parse(parser: &mut Parser<Ref>) -> Result<Self, ParseError>

Extracts a value from the beginning of parser.

fn skip(parser: &mut Parser<Ref>) -> Result<(), ParseError>

Skips over a value of this type at the beginning of parser.

impl<Octets, Other> PartialEq<Txt<Other>> for Txt<Octets> where
    Octets: AsRef<[u8]>,
    Other: AsRef<[u8]>, 

fn eq(&self, other: &Txt<Other>) -> 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<Octets, Other> PartialOrd<Txt<Other>> for Txt<Octets> where
    Octets: AsRef<[u8]>,
    Other: AsRef<[u8]>, 

fn partial_cmp(&self, other: &Txt<Other>) -> 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.

impl<Octets> RtypeRecordData for Txt<Octets>

const RTYPE: Rtype

The record type of a value of this type.