Struct Txt 

pub struct Txt { /* private fields */ }

Available on crate features dns and std only.

One validated TXT-record RDATA value.

A TXT record contains one or more binary DNS character-strings. Record and string boundaries are preserved in one shared, canonical wire buffer.

Implementations

impl Txt

pub fn parse_rdata(rdata: &[u8]) -> Result<Txt, TxtParseError>

Parse one complete borrowed TXT RDATA value.

Validation occurs before one exact-sized copy. Use Self::parse_rdata_bytes when the caller already owns a proportionately sized Bytes value.

pub fn parse_rdata_bytes(rdata: &Bytes) -> Result<Txt, TxtParseError>

Parse one complete owned TXT RDATA value without copying its strings.

Retaining a slice also retains its parent allocation. Callers should use this only when that allocation is already proportionate to this record, and use Self::parse_rdata for slices of oversized packets or callback storage.

pub fn try_from_strings<I, S>(strings: I) -> Result<Txt, TxtParseError>

where I: IntoIterator<Item = S>, S: AsRef<[u8]>,

Construct one TXT record from decoded binary character-strings.

At least one string is required. Every string may contain arbitrary octets but must be at most 255 octets long, and their complete encoded RDATA must fit the DNS 16-bit RDLENGTH field.

pub const fn len(&self) -> usize

Return the number of character-strings in this record.

pub fn as_wire(&self) -> &[u8]

Return the complete length-prefixed TXT RDATA wire value.

pub fn iter(&self) -> impl ExactSizeIterator + FusedIterator + Clone

Iterate over borrowed binary character-strings.

pub fn into_strings(self) -> impl ExactSizeIterator + FusedIterator + Clone

Consume this record and iterate over zero-copy owned string slices.

Every yielded slice shares the complete record allocation. Prefer Self::iter and copy an individual string when it must outlive a much larger record without retaining that record.

Trait Implementations

impl Clone for Txt

fn clone(&self) -> Txt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Txt

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

Formats the value using the given formatter.

impl Display for Txt

Formats a human-readable diagnostic while preserving string boundaries.

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

Formats the value using the given formatter.

impl DnsTxtResolver for Txt

type Error = !

Error returned by the DnsTxtResolver

fn lookup_txt( &self, _: Domain, ) -> impl Stream<Item = Result<Txt, <Txt as DnsTxtResolver>::Error>> + Send

Resolve the TXT records accessible for the given Domain.

fn into_box_dns_txt_resolver(self) -> BoxDnsTxtResolver

Box this resolver to allow for dynamic dispatch.

impl Eq for Txt

impl PartialEq for Txt

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Txt