Struct domain::rdata::svcb::value::Ipv4Hint

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

The ‘ipv4hint’ service parameter value.

This values provides a list of IPv4 addresses that the client may use to connect to the endpoint. The value is intended to speed up connecting but not to replace the A query to get the actual IPv4 addresses of the endpoint. That is, the client can start an A query and at the same time connect to an IP address from the value. If the A query doesn’t return this IP address, it may want to start again with an address from the response.

The type contains the value in its wire format which consists of the sequence of IPv4 addresses.

Implementations

impl<Octs> Ipv4Hint<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 Ipv4Hint<[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> Ipv4Hint<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]> + ?Sized> Ipv4Hint<Octs>

pub fn iter(&self) -> Ipv4HintIter<'_, Octs>

Returns an iterator over the elements of the value.

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

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

Creates a new ipv4hint value from its content.

The function returns an error if octets doesn’t contain a correctly encoded value or if it is longer than 65,535 octets.

pub fn from_addrs( addrs: impl IntoIterator<Item = Ipv4Addr>, ) -> Result<Self, BuildValueError>

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

Creates a new value from a list of IPv4 addresses.

The function will fail if the iterator returns more than 16,383 addresses or if the octets builder to be used for building runs out of space.

impl Ipv4Hint<[u8]>

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

Creates a new ipv4hint value from a slice of its content.

The function returns an error if slice doesn’t contain a correctly encoded value or if it is longer than 65,535 octets.

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

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

Parses an ipv4hint value from its wire format.

Trait Implementations

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

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

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

impl<Octs> AsRef<Octs> for Ipv4Hint<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 Ipv4Hint<Octs>

fn clone(&self) -> Ipv4Hint<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 Ipv4Hint<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 Ipv4Hint<Octs>

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

Formats the value using the given formatter.

impl<Octs: Octets + ?Sized> Display for Ipv4Hint<Octs>

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

Formats the value using the given formatter.

impl<Octs> From<Ipv4Hint<Octs>> for AllValues<Octs>

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

Converts to this type from the input type.

impl<Octs: AsRef<[u8]>> Hash for Ipv4Hint<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<Ipv4Hint<O>> for Ipv4Hint<OO>

where OO: OctetsFrom<O>,

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

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

Performs the conversion.

impl<'a, Octs> ParseSvcParamValue<'a, Octs> for Ipv4Hint<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<Ipv4Hint<OtherOcts>> for Ipv4Hint<Octs>

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

fn eq(&self, other: &Ipv4Hint<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 Ipv4Hint<Octs>

fn key(&self) -> SvcParamKey

Returns the parameter key of the value.

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