Struct OwnerHash

pub struct OwnerHash<Octs: ?Sized>(/* private fields */);

The hash over the next owner name.

This hash is used instead of the actual owner name in an NSEC3 record.

The hash can never be longer than 255 octets since its length is encoded as a single octet.

For its presentation format, the hash uses an unpadded Base 32 encoding with no whitespace allowed.

Implementations

impl OwnerHash<()>

pub const MAX_LEN: usize = 255usize

The hash has a maximum length 255 octets since its length is encoded as a single octet.

impl<Octs> OwnerHash<Octs>

pub fn from_octets(octets: Octs) -> Result<Self, OwnerHashError>

where Octs: AsRef<[u8]>,

Creates a new owner hash from the given octets.

Returns succesfully if octets can indeed be used as a character string, i.e., it is not longer than 255 bytes.

pub fn scan<S: Scanner<Octets = Octs>>( scanner: &mut S, ) -> Result<Self, S::Error>

pub fn into_octets(self) -> Octs

where Octs: Sized,

Converts the hash into the underlying octets.

impl<Octs: ?Sized> OwnerHash<Octs>

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

where Octs: AsRef<[u8]>,

Returns a reference to a slice of the hash.

impl OwnerHash<Bytes>

pub fn from_bytes(bytes: Bytes) -> Result<Self, OwnerHashError>

Creates a new owner hash from a bytes value.

impl OwnerHash<[u8]>

pub fn from_slice(slice: &[u8]) -> Result<&Self, OwnerHashError>

Creates a new owner hash from an octet slice.

Trait Implementations

impl<Octs: AsRef<U> + ?Sized, U: ?Sized> AsRef<U> for OwnerHash<Octs>

fn as_ref(&self) -> &U

Converts this type into a shared reference of the (usually inferred) input type.

impl<T, U> CanonicalOrd<OwnerHash<U>> for OwnerHash<T>

where T: AsRef<[u8]> + ?Sized, U: AsRef<[u8]> + ?Sized,

fn canonical_cmp(&self, other: &OwnerHash<U>) -> Ordering

Returns the canonical ordering between self and other.

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

Returns whether self is canonically less than other.

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

Returns whether self is canonically less than or equal to other.

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

Returns whether self is canonically greater than other.

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

Returns whether self is canonically greater than or equal to other.

impl<Octs: Clone + ?Sized> Clone for OwnerHash<Octs>

fn clone(&self) -> OwnerHash<Octs>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]> + ?Sized> Debug for OwnerHash<Octs>

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

Formats the value using the given formatter.

impl<Octs: AsRef<[u8]> + ?Sized> Display for OwnerHash<Octs>

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

Formats the value using the given formatter.

impl<Octs> FromStr for OwnerHash<Octs>

where Octs: FromBuilder, <Octs as FromBuilder>::Builder: OctetsBuilder + EmptyBuilder,

type Err = DecodeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<T: AsRef<[u8]> + ?Sized> Hash for OwnerHash<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

impl<Octs, SrcOcts> OctetsFrom<OwnerHash<SrcOcts>> for OwnerHash<Octs>

where Octs: OctetsFrom<SrcOcts>,

type Error = <Octs as OctetsFrom<SrcOcts>>::Error

fn try_octets_from(source: OwnerHash<SrcOcts>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T: AsRef<[u8]> + ?Sized> Ord for OwnerHash<T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

impl<T, U> PartialEq<U> for OwnerHash<T>

where T: AsRef<[u8]> + ?Sized, U: AsRef<[u8]> + ?Sized,

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T, U> PartialOrd<U> for OwnerHash<T>

where T: AsRef<[u8]> + ?Sized, U: AsRef<[u8]> + ?Sized,

fn partial_cmp(&self, other: &U) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: AsRef<[u8]> + ?Sized> Eq for OwnerHash<T>