Struct HTTPS

pub struct HTTPS<'a>(pub SVCB<'a>);

HTTPS RR type is a SVCB-compatible RR type, specific to the “https” and “http” schemes. RFC 9460.

Tuple Fields

0: SVCB<'a>

Implementations

impl<'a> HTTPS<'a>

pub fn into_owned<'b>(self) -> HTTPS<'b>

Transforms the inner data into its owned type

Methods from Deref<Target = SVCB<'a>>

pub const MANDATORY: u16 = 0u16

pub const ALPN: u16 = 1u16

pub const NO_DEFAULT_ALPN: u16 = 2u16

pub const PORT: u16 = 3u16

pub const IPV4HINT: u16 = 4u16

pub const ECH: u16 = 5u16

pub const IPV6HINT: u16 = 6u16

pub fn set_param<V: Into<Cow<'a, [u8]>>>( &mut self, key: u16, value: V, ) -> Result<()>

Sets an arbitrary key=value parameter.

The format of value is not checked against the key.

If a parameter of the given key already existed, the previous entry will be replaced.

pub fn set_mandatory<I: IntoIterator<Item = u16>>( &mut self, keys: I, ) -> Result<()>

Sets the “mandatory” parameter.

The keys MUST not be empty and already in strictly increasing order.

pub fn set_alpn<'cs, I: IntoIterator<Item = CharacterString<'cs>>>( &mut self, alpn_ids: I, ) -> Result<()>

Sets the “alpn” parameter.

The alpn_ids MUST not be empty.

pub fn set_no_default_alpn(&mut self)

Sets the “no-default-alpn” parameter.

pub fn set_port(&mut self, port: u16)

Sets the “port” parameter.

pub fn set_ipv4hint<I: IntoIterator<Item = u32>>( &mut self, ips: I, ) -> Result<()>

Sets the “ipv4hint” parameter.

The ips MUST not be empty.

pub fn set_ipv6hint<I: IntoIterator<Item = u128>>( &mut self, ips: I, ) -> Result<()>

Sets the “ipv6hint” parameter.

The ips MUST not be empty.

pub fn get_param(&self, key: u16) -> Option<&[u8]>

Gets a read-only reference to the SvcParamValue of a given key in wire format.

Returns None if the key does not exist.

pub fn iter_params(&self) -> impl Iterator<Item = (u16, &[u8])>

Iterates over all parameters.

Trait Implementations

impl<'a> Clone for HTTPS<'a>

fn clone(&self) -> HTTPS<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for HTTPS<'a>

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

Formats the value using the given formatter.

impl<'a> Deref for HTTPS<'a>

type Target = SVCB<'a>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a> DerefMut for HTTPS<'a>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a> From<SVCB<'a>> for HTTPS<'a>

fn from(value: SVCB<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for HTTPS<'a>

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<'a> PartialEq for HTTPS<'a>

fn eq(&self, other: &HTTPS<'a>) -> 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<'a> Eq for HTTPS<'a>

impl<'a> StructuralPartialEq for HTTPS<'a>