Struct TXT 

pub struct TXT<'a> { /* private fields */ }

Represents a TXT Resource Record

Implementations

impl<'a> TXT<'a>

pub fn new() -> Self

Creates a new empty TXT Record

pub fn add_string(&mut self, char_string: &'a str) -> Result<()>

Add char_string to this TXT record as a validated CharacterString

pub fn add_char_string(&mut self, char_string: CharacterString<'a>)

Add char_string to this TXT record

pub fn with_string(self, char_string: &'a str) -> Result<Self>

Add char_string to this TXT record as a validated CharacterString, consuming and returning Self

pub fn with_char_string(self, char_string: CharacterString<'a>) -> Self

Add char_string to this TXT record, consuming and returning Self

pub fn iter_raw(&self) -> impl Iterator<Item = (&[u8], Option<&[u8]>)>

Returns parsed attributes from this TXT Record as bytes, valid formats are:

• key=value
• key=
• key

pub fn add_attribute(&mut self, key: &str, value: Option<&[u8]>) -> Result<()>

Add a key/value attribute to this TXT record per RFC 6763 Section 6.

The key must be non-empty printable US-ASCII (0x20..=0x7E) excluding =. The optional value may contain arbitrary binary bytes, as long as the combined key=value fits within a 255-byte CharacterString.

pub fn with_attribute(self, key: &str, value: Option<&[u8]>) -> Result<Self>

Add a key/value attribute to this TXT record, consuming and returning Self.

pub fn attributes(&self) -> HashMap<String, Option<String>>

Returns parsed attributes from this TXT Record, valid formats are:

• key=value
• key=
• key

If a key is duplicated, only the first one will be considered (case-insensitive per RFC 6763 Section 6.4)

pub fn long_attributes(self) -> Result<HashMap<String, Option<String>>>

Similar to attributes() but it parses the full TXT record as a single string, instead of expecting each attribute to be a separate CharacterString

pub fn into_owned<'b>(self) -> TXT<'b>

Transforms the inner data into its owned type

Trait Implementations

impl<'a> Clone for TXT<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for TXT<'a>

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

Formats the value using the given formatter.

impl Default for TXT<'_>

fn default() -> Self

Returns the “default value” for a type.

impl<'a> Eq for TXT<'a>

impl<'a> Hash for TXT<'a>

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

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for TXT<'a>

impl<'a> TryFrom<&'a str> for TXT<'a>

type Error = SimpleDnsError

The type returned in the event of a conversion error.

fn try_from(value: &'a str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<HashMap<String, Option<String>>> for TXT<'_>

Available on crate feature std only.

type Error = SimpleDnsError

The type returned in the event of a conversion error.

fn try_from(value: HashMap<String, Option<String>>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<TXT<'a>> for String

type Error = FromUtf8Error

The type returned in the event of a conversion error.

fn try_from(val: TXT<'a>) -> Result<Self, Self::Error>

Performs the conversion.