Module domain::base::iana

Expand description

IANA Definitions for DNS.

This module contains enums for parameters defined in IANA registries that are relevant for this crate.

All types defined hereunder follow the same basic structure. They are all enums with all well-defined values as variants. In addition they have an Int variant that contains a raw integer value. Since we cannot restrict that integer to only the undefined values, we generally allow the full set of possible values. We treat this correctly, meaning that the well-defined variant and the Int variant with the same integer value compare to equal.

There are two methods from_int() and to_int() to convert from and to raw integer values as well as implementations of the From trait for these. FromStr and Display are implemented to convert from the string codes to the values and back. All of these are essentially giant matches which may or may not be the smartest way to do this.

Types also implement parse() and scan() functions for creation from wire format and master format, respectively, as well as a compose() method for composing into wire format data.

While each parameter type has a module of its own, they are all re-exported here. This is mostly so we can have associated types like FromStrError without having to resort to devilishly long names.