Struct domain::rdata::svcb::value::Alpn

source ·
pub struct Alpn<Octs: ?Sized>(/* private fields */);
Expand description

The application layer protocols supported by the service endpoint.

This value lists the protocol names supported by the service endpoint described by the service binding’s target name and, if present, port. The names are the same as used by Application Layer Protocol Negotiation (ALPN) described in [RFC 7301]. Each scheme that uses service bindings defines a set of default protocols that are quietly added to this list unless the NoDefaultAlpn value is present as well. For HTTPS, this default set consists of the "http/1.1" protocol.

The wire format of this value consists of those protocol names each preceeded by a u8 giving their length.

The iter method produces an iterator over the individual protocol names in the value.

Implementations§

source§

impl<Octs> Alpn<Octs>

source

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.

source§

impl Alpn<[u8]>

source

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.

source§

impl<Octs: ?Sized> Alpn<Octs>

source

pub fn as_octets(&self) -> &Octs

Returns a reference to the underlying octets sequence.

source

pub fn as_slice(&self) -> &[u8]
where Octs: AsRef<[u8]>,

Returns a slice of the underlying octets sequence.

source§

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

source

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

Returns an iterator over the elements of the value.

source§

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

source

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

Creates an ALPN value from the underlying octets.

The function ensures that octets is a correctly encoded ALPN value. It does not, however, check that the protocol identifiers are valid.

source§

impl Alpn<[u8]>

source

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

Creates an ALPN value from an octets slice.

The function ensures that slice is a correctly encoded ALPN value. It does not, however, check that the protocol identifiers are valid.

source§

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

source

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

Parses an ALPN value from its wire format.

Trait Implementations§

source§

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

source§

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

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

impl<Octs> AsRef<Octs> for Alpn<Octs>

source§

fn as_ref(&self) -> &Octs

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

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

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

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

source§

fn compose_len(&self) -> u16

Returns the length of the composed value.
source§

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.
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

impl<Octs> From<Alpn<Octs>> for AllValues<Octs>

source§

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

Converts to this type from the input type.
source§

impl<Octs: AsRef<[u8]>> Hash for Alpn<Octs>

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl<O, OO> OctetsFrom<Alpn<O>> for Alpn<OO>
where OO: OctetsFrom<O>,

§

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

source§

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

Performs the conversion.
source§

impl<'a, Octs> ParseSvcParamValue<'a, Octs> for Alpn<Octs::Range<'a>>
where Octs: Octets + ?Sized,

source§

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

Parse a parameter value from wire format. Read more
source§

impl<Octs, OtherOcts> PartialEq<Alpn<OtherOcts>> for Alpn<Octs>
where Octs: AsRef<[u8]>, OtherOcts: AsRef<[u8]>,

source§

fn eq(&self, other: &Alpn<OtherOcts>) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<Octs: ?Sized> SvcParamValue for Alpn<Octs>

source§

fn key(&self) -> SvcParamKey

Returns the parameter key of the value.
source§

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

Auto Trait Implementations§

§

impl<Octs> Freeze for Alpn<Octs>
where Octs: Freeze + ?Sized,

§

impl<Octs> RefUnwindSafe for Alpn<Octs>
where Octs: RefUnwindSafe + ?Sized,

§

impl<Octs> Send for Alpn<Octs>
where Octs: Send + ?Sized,

§

impl<Octs> Sync for Alpn<Octs>
where Octs: Sync + ?Sized,

§

impl<Octs> Unpin for Alpn<Octs>
where Octs: Unpin + ?Sized,

§

impl<Octs> UnwindSafe for Alpn<Octs>
where Octs: UnwindSafe + ?Sized,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Source, Target> OctetsInto<Target> for Source
where Target: OctetsFrom<Source>,

§

type Error = <Target as OctetsFrom<Source>>::Error

source§

fn try_octets_into( self, ) -> Result<Target, <Source as OctetsInto<Target>>::Error>

Performs the conversion.
source§

fn octets_into(self) -> Target
where Self::Error: Into<Infallible>,

Performs an infallible conversion.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V