Struct domain::rdata::rfc1035::Txt

source ·
pub struct Txt<Octs: ?Sized>(_);
Expand description

Txt record data.

Txt records hold descriptive text.

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

Implementations§

source§

impl<Octs: FromBuilder> Txt<Octs>

source

pub fn build_from_slice(text: &[u8]) -> Result<Self, ShortBuf>where <Octs as FromBuilder>::Builder: EmptyBuilder + AsRef<[u8]> + AsMut<[u8]>,

Creates a new Txt record from a single character string.

source§

impl<Octs> Txt<Octs>

source

pub fn from_octets(octets: Octs) -> Result<Self, TxtError>where Octs: AsRef<[u8]>,

Creates new TXT record data from its encoded content.

source§

impl Txt<[u8]>

source

pub fn from_slice(slice: &[u8]) -> Result<&Self, TxtError>

Creates new TXT record data on an octets slice.

source§

impl<Octs> Txt<Octs>

source

pub fn parse<'a, Src: Octets<Range<'a> = Octs> + ?Sized>( parser: &mut Parser<'a, Src> ) -> Result<Self, ParseError>where Octs: AsRef<[u8]>,

source

pub fn scan<S: Scanner<Octets = Octs>>( scanner: &mut S ) -> Result<Self, S::Error>

source§

impl<Octs: AsRef<[u8]> + ?Sized> Txt<Octs>

source

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.

source

pub fn iter_char_strs(&self) -> TxtCharStrIter<'_>

source

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

Returns the content if it consists of a single character string.

source

pub fn len(&self) -> usize

source

pub fn is_empty(&self) -> bool

source

pub fn try_text<T: FromBuilder>( &self ) -> Result<T, <<T as FromBuilder>::Builder as OctetsBuilder>::AppendError>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.

source

pub fn text<T: FromBuilder>(&self) -> Twhere <T as FromBuilder>::Builder: EmptyBuilder, <<T as FromBuilder>::Builder as OctetsBuilder>::AppendError: Into<Infallible>,

source§

impl<SrcOcts> Txt<SrcOcts>

source

pub fn flatten_into<Octs>(self) -> Result<Txt<Octs>, PushError>where Octs: OctetsFrom<SrcOcts>,

Trait Implementations§

source§

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

source§

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

Returns the canonical ordering between self and other.
source§

fn canonical_lt(&self, other: &Rhs) -> bool

Returns whether self is canonically less than other.
source§

fn canonical_le(&self, other: &Rhs) -> bool

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

fn canonical_gt(&self, other: &Rhs) -> bool

Returns whether self is canonically greater than other.
source§

fn canonical_ge(&self, other: &Rhs) -> bool

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

impl<Octs: Clone + ?Sized> Clone for Txt<Octs>

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<Octs: AsRef<[u8]>> ComposeRecordData for Txt<Octs>

source§

fn rdlen(&self, _compress: bool) -> Option<u16>

Returns the length of the record data if available. Read more
source§

fn compose_rdata<Target: Composer + ?Sized>( &self, target: &mut Target ) -> Result<(), Target::AppendError>

Appends the wire format of the record data into target.
source§

fn compose_canonical_rdata<Target: Composer + ?Sized>( &self, target: &mut Target ) -> Result<(), Target::AppendError>

Appends the canonical wire format of the record data into target.
source§

fn compose_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.
source§

fn compose_canonical_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<'a, Octs: AsRef<[u8]>> IntoIterator for &'a Txt<Octs>

§

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?
source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
source§

impl<Octs, SrcOcts> OctetsFrom<Txt<SrcOcts>> for Txt<Octs>where Octs: OctetsFrom<SrcOcts>,

§

type Error = <Octs as OctetsFrom<SrcOcts>>::Error

source§

fn try_octets_from(source: Txt<SrcOcts>) -> Result<Self, Self::Error>

Performs the conversion.
source§

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

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · source§

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval. Read more
source§

impl<'a, Octs> ParseRecordData<'a, Octs> for Txt<Octs::Range<'a>>where Octs: Octets + ?Sized,

source§

fn parse_rdata( rtype: Rtype, parser: &mut Parser<'a, Octs> ) -> Result<Option<Self>, ParseError>

Parses the record data. Read more
source§

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

source§

fn eq(&self, other: &Txt<Other>) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<Octs, Other> PartialOrd<Txt<Other>> for Txt<Octs>where Octs: AsRef<[u8]>, Other: AsRef<[u8]>,

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

fn ge(&self, other: &Rhs) -> bool

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

impl<Octs> RecordData for Txt<Octs>

source§

fn rtype(&self) -> Rtype

Returns the record type associated with this record data instance. Read more
source§

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

Auto Trait Implementations§

§

impl<Octs: ?Sized> RefUnwindSafe for Txt<Octs>where Octs: RefUnwindSafe,

§

impl<Octs: ?Sized> Send for Txt<Octs>where Octs: Send,

§

impl<Octs: ?Sized> Sync for Txt<Octs>where Octs: Sync,

§

impl<Octs: ?Sized> Unpin for Txt<Octs>where Octs: Unpin,

§

impl<Octs: ?Sized> UnwindSafe for Txt<Octs>where Octs: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Source, Target> OctetsInto<Target> for Sourcewhere Target: OctetsFrom<Source>,

§

type Error = <Target as OctetsFrom<Source>>::Error

source§

fn try_octets_into( self ) -> Result<Target, <Source as OctetsInto<Target>>::Error>

Performs the conversion.
source§

fn octets_into(self) -> Targetwhere Self::Error: Into<Infallible>,

Performs an infallible conversion.
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for Twhere T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

source§

fn vzip(self) -> V