Struct trust_dns_proto::rr::rdata::txt::TXT

pub struct TXT { /* private fields */ }

RFC 1035, DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION, November 1987

3.3.14. TXT RDATA format

    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    /                   TXT-DATA                    /
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+


TXT RRs are used to hold descriptive text.  The semantics of the text
depends on the domain where it is found.

Implementations

impl TXT

pub fn new(txt_data: Vec<String>) -> Self

Creates a new TXT record data.

Arguments

• txt_data - the set of strings which make up the txt_data.

Return value

The new TXT record data.

pub fn from_bytes(txt_data: Vec<&[u8]>) -> Self

Creates a new TXT record data from bytes. Allows creating binary record data.

Arguments

• txt_data - the set of bytes which make up the txt_data.

Return value

The new TXT record data.

pub fn txt_data(&self) -> &[Box<[u8]>]

TXT-DATA        One or more <character-string>s.

pub fn iter(&self) -> Iter<'_, Box<[u8]>>

Returns an iterator over the arrays in the txt data

Trait Implementations

impl BinEncodable for TXT

fn emit(&self, encoder: &mut BinEncoder<'_>) -> ProtoResult<()>

Write the type to the stream

fn to_bytes(&self) -> ProtoResult<Vec<u8>>

Returns the object in binary form

impl Clone for TXT

fn clone(&self) -> TXT

Returns a copy 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

Formats the value using the given formatter.

impl Display for TXT

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

Format a TXT with lossy conversion of invalid utf8.

Case of invalid utf8

Invalid utf8 will be converted to: U+FFFD REPLACEMENT CHARACTER, which looks like this: �

Same behaviour as alloc::string::String::from_utf8_lossy.

let first_bytes = b"Invalid utf8 <\xF0\x90\x80>.";
let second_bytes = b" Valid utf8 <\xF0\x9F\xA4\xA3>";
let rdata: Vec<&[u8]> = vec![first_bytes, second_bytes];
let txt = TXT::from_bytes(rdata);

let tested = format!("{}", txt);
assert_eq!(
    tested.as_bytes(),
    b"Invalid utf8 <\xEF\xBF\xBD>. Valid utf8 <\xF0\x9F\xA4\xA3>",
    "Utf8 lossy conversion error! Mismatch between input and expected"
);

impl Hash for TXT

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 PartialEq for TXT

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

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

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.

impl RecordData for TXT

fn try_from_rdata(data: RData) -> Result<Self, RData>

Attempts to convert to this RecordData from the RData type, if it is not the correct type the original is returned

fn try_borrow(data: &RData) -> Option<&Self>

Attempts to borrow this RecordData from the RData type, if it is not the correct type the original is returned

fn record_type(&self) -> RecordType

Get the associated RecordType for the RecordData

fn into_rdata(self) -> RData

Converts this RecordData into generic RecordData

impl Eq for TXT

impl StructuralPartialEq for TXT