Struct DohPath

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

The ‘dohpath’ service parameter value.

This value includes the URI template to be used when directing DNS-over-HTTPS (DoH) queries to a service. This template is encoded as UTF-8. URI templates are described in RFC 6570

This value type is described as part of the specification for using service bindings with DNS-over-HTTPS, currently draft-ietf-add-svcb-dns.

Implementations

impl<Octs> DohPath<Octs>

pub unsafe fn from_octets_unchecked(octets: Octs) -> Self

Creates a new value from octets without checking.

Safety

The caller has to ensure that octets contains a properly formated value of at most 65,535 octets.

impl DohPath<[u8]>

pub unsafe fn from_slice_unchecked(slice: &[u8]) -> &Self

Creates a new value for a slice without checking.

Safety

The caller has to ensure that slice contains a properly formated value of at most 65,535 octets.

impl<Octs: ?Sized> DohPath<Octs>

pub fn as_octets(&self) -> &Octs

Returns a reference to the underlying octets sequence.

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

where Octs: AsRef<[u8]>,

Returns a slice of the underlying octets sequence.

impl<Octs: AsRef<[u8]>> DohPath<Octs>

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

Creates a ‘dohpath’ value from its content.

Returns an error if octets is longer than 65,535 bytes.

impl DohPath<[u8]>

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

Creates a ‘dohpath’ value from a slice of its content.

Returns an error if slice is longer than 65,535 bytes.

impl<Octs: AsRef<[u8]>> DohPath<Octs>

pub fn parse<'a, Src: Octets<Range<'a> = Octs> + ?Sized>( parser: &mut Parser<'a, Src>, ) -> Result<Self, ParseError>

Parses a ‘dohpath’ value from its wire format.

Trait Implementations

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

fn as_ref(&self) -> &[u8]

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

impl<Octs> AsRef<Octs> for DohPath<Octs>

fn as_ref(&self) -> &Octs

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

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]> + ?Sized> ComposeSvcParamValue for DohPath<Octs>

fn compose_len(&self) -> u16

Returns the length of the composed value.

fn compose_value<Target: OctetsBuilder + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the wire format of the value to the end of target.

impl<Octs: Debug + ?Sized> Debug for DohPath<Octs>

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter.

impl<Octs> From<DohPath<Octs>> for AllValues<Octs>

fn from(p: DohPath<Octs>) -> Self

Converts to this type from the input type.

impl<Octs> FromStr for DohPath<Octs>

where Octs: FromBuilder, <Octs as FromBuilder>::Builder: EmptyBuilder + FreezeBuilder<Octets = Octs>,

type Err = BuildValueError

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<Octs: AsRef<[u8]>> Hash for DohPath<Octs>

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<O, OO> OctetsFrom<DohPath<O>> for DohPath<OO>

where OO: OctetsFrom<O>,

type Error = <OO as OctetsFrom<O>>::Error

fn try_octets_from(source: DohPath<O>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, Octs> ParseSvcParamValue<'a, Octs> for DohPath<Octs::Range<'a>>

where Octs: Octets + ?Sized,

fn parse_value( key: SvcParamKey, parser: &mut Parser<'a, Octs>, ) -> Result<Option<Self>, ParseError>

Parse a parameter value from wire format.

impl<Octs, OtherOcts> PartialEq<DohPath<OtherOcts>> for DohPath<Octs>

where Octs: AsRef<[u8]>, OtherOcts: AsRef<[u8]>,

fn eq(&self, other: &DohPath<OtherOcts>) -> 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<Octs: ?Sized> SvcParamValue for DohPath<Octs>

fn key(&self) -> SvcParamKey

Returns the parameter key of the value.

impl<Octs: AsRef<[u8]>> TryFrom<Str<Octs>> for DohPath<Octs>

type Error = LongSvcParam

The type returned in the event of a conversion error.

fn try_from(src: Str<Octs>) -> Result<Self, Self::Error>

Performs the conversion.

impl<Octs: AsRef<[u8]>> Eq for DohPath<Octs>