Module charstr

Character strings.

The somewhat ill-named <character-string> is defined in RFC 1035 as binary information of up to 255 octets. As such, it doesn’t necessarily contain (ASCII-) characters nor is it a string in a Rust-sense.

An existing, immutable character string is represented by the type CharStr. The type CharStrBuilder allows constructing a character string from individual octets or octets slices.

In wire-format, character strings are encoded as one octet giving the length followed by the actual data in that many octets. The length octet is not part of the content wrapped by CharStr, it contains the data only.

A CharStr can be constructed from a string via the FromStr trait. In this case, the string must consist only of printable ASCII characters. Space and double quote are allowed and will be accepted with their ASCII value. Other values need to be escaped via a backslash followed by the three-digit decimal representation of the value. In addition, a backslash followed by a non-digit printable ASCII character is accepted, too, with the ASCII value of this character used.

Structs

• CharStr
  The content of a DNS character string.
• CharStrBuilder
  A builder for a character string.
• CharStrError
  A byte sequence does not represent a valid character string.
• DisplayQuoted
  Helper struct for displaying in quoted presentation format.
• DisplayUnquoted
  Helper struct for displaying in serialization format.
• IntoIter
  The iterator type for IntoIterator for a character string itself.
• Iter
  The iterator type for IntoIterator for a reference to a character string.
• PresentationError
  An illegal presentation format was encountered.

Enums

• FromStrError
  An error happened when converting a Rust string to a DNS character string.