Struct Extensions

pub struct Extensions { /* private fields */ }

A list of extensions with unique extension types.

Implementations

impl Extensions

pub fn empty() -> Self

Create an empty extension list.

pub fn single(extension: Extension) -> Self

Create an extension list with a single extension.

pub fn from_vec( extensions: Vec<Extension>, ) -> Result<Self, InvalidExtensionError>

Create an extension list with multiple extensions.

This function will fail when the list of extensions contains duplicate extension types.

pub fn iter(&self) -> impl Iterator<Item = &Extension>

Returns an iterator over the extension list.

pub fn add(&mut self, extension: Extension) -> Result<(), InvalidExtensionError>

Add an extension to the extension list.

Returns an error when there already is an extension with the same extension type.

pub fn add_or_replace(&mut self, extension: Extension) -> Option<Extension>

Add an extension to the extension list (or replace an existing one.)

Returns the replaced extension (if any).

pub fn remove(&mut self, extension_type: ExtensionType) -> Option<Extension>

Remove an extension from the extension list.

Returns the removed extension or None when there is no extension with the given extension type.

pub fn contains(&self, extension_type: ExtensionType) -> bool

Returns true iff the extension list contains an extension with the given extension type.

impl Extensions

pub fn application_id(&self) -> Option<&ApplicationIdExtension>

Get a reference to the ApplicationIdExtension if there is any.

pub fn ratchet_tree(&self) -> Option<&RatchetTreeExtension>

Get a reference to the RatchetTreeExtension if there is any.

pub fn required_capabilities(&self) -> Option<&RequiredCapabilitiesExtension>

Get a reference to the RequiredCapabilitiesExtension if there is any.

pub fn external_pub(&self) -> Option<&ExternalPubExtension>

Get a reference to the ExternalPubExtension if there is any.

pub fn external_senders(&self) -> Option<&ExternalSendersExtension>

Get a reference to the ExternalSendersExtension if there is any.

pub fn unknown(&self, extension_type_id: u16) -> Option<&UnknownExtension>

Get a reference to the UnknownExtension with the given type id, if there is any.

Trait Implementations

impl Clone for Extensions

fn clone(&self) -> Extensions

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Extensions

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

Formats the value using the given formatter.

impl Default for Extensions

fn default() -> Extensions

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Extensions

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Deserialize for Extensions

fn tls_deserialize<R: Read>(bytes: &mut R) -> Result<Self, Error>

where Self: Sized,

This function deserializes the bytes from the provided a std::io::Read and returns the populated struct.

fn tls_deserialize_exact(bytes: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

This function deserializes the provided bytes and returns the populated struct. All bytes must be consumed.

impl DeserializeBytes for Extensions

fn tls_deserialize_bytes(bytes: &[u8]) -> Result<(Self, &[u8]), Error>

where Self: Sized,

This function deserializes the bytes from the provided a &[u8] and returns the populated struct, as well as the remaining slice.

fn tls_deserialize_exact_bytes(bytes: &[u8]) -> Result<Self, Error>

where Self: Sized,

This function deserializes the provided bytes and returns the populated struct. All bytes must be consumed.

impl PartialEq for Extensions

fn eq(&self, other: &Extensions) -> 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 Serialize for Extensions

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Serialize for Extensions

fn tls_serialize<W: Write>(&self, writer: &mut W) -> Result<usize, Error>

Serialize self and write it to the writer. The function returns the number of bytes written to writer.

fn tls_serialize_detached(&self) -> Result<Vec<u8>, Error>

Serialize self and return it as a byte vector.

impl Size for &Extensions

fn tls_serialized_len(&self) -> usize

impl Size for Extensions

fn tls_serialized_len(&self) -> usize

impl TryFrom<Vec<Extension>> for Extensions

type Error = InvalidExtensionError

The type returned in the event of a conversion error.

fn try_from(candidate: Vec<Extension>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Extensions

impl StructuralPartialEq for Extensions