Skip to main content

HeaderExtension

Struct HeaderExtension 

Source
pub struct HeaderExtension<'a> {
    pub het: u8,
    pub content: &'a [u8],
}
Expand description

One LCT/NORM header extension (RFC 5651 §5.2 / RFC 5740 §4.1).

The content is everything in the extension after the leading HET byte and (for variable-length extensions) the HEL byte:

  • variable-length (het < 128): content.len() is 4*HEL − 2, and may be any length whose total (+2) is a multiple of 4.
  • fixed-length (het >= 128): content is exactly the 3 bytes after HET.

HEL is not stored: it is recomputed from content.len() on serialize, so the round-trip is driven entirely from the typed fields (no raw passthrough).

Fields§

§het: u8

Header Extension Type.

§content: &'a [u8]

The extension content bytes (after HET, and after HEL when present).

Implementations§

Source§

impl<'a> HeaderExtension<'a>

Source

pub fn new(het: u8, content: &'a [u8]) -> Self

Construct a variable- or fixed-length extension from its HET and content.

Source

pub fn is_fixed(&self) -> bool

true if this is a fixed-length extension (HET ≥ 128, one 32-bit word).

Source

pub fn serialized_len(&self) -> usize

Total serialized size in bytes (always a multiple of 4).

Source

pub fn hel(&self) -> usize

The HEL value as it appears on the wire (whole extension length in 32-bit words). Only meaningful for variable-length extensions.

Source

pub fn parse(data: &'a [u8]) -> Result<(Self, usize)>

Parse a single header extension from the start of data. Returns the extension and the number of bytes consumed.

Source

pub fn serialize_into(&self, out: &mut [u8]) -> Result<usize>

Serialize this extension into out, recomputing HEL from the content length. Returns the number of bytes written.

Trait Implementations§

Source§

impl<'a> Clone for HeaderExtension<'a>

Source§

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

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<'a> Debug for HeaderExtension<'a>

Source§

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

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

impl<'a> Eq for HeaderExtension<'a>

Source§

impl<'a> PartialEq for HeaderExtension<'a>

Source§

fn eq(&self, other: &HeaderExtension<'a>) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl<'a> Serialize for HeaderExtension<'a>

Available on crate feature serde only.
Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl<'a> StructuralPartialEq for HeaderExtension<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for HeaderExtension<'a>

§

impl<'a> RefUnwindSafe for HeaderExtension<'a>

§

impl<'a> Send for HeaderExtension<'a>

§

impl<'a> Sync for HeaderExtension<'a>

§

impl<'a> Unpin for HeaderExtension<'a>

§

impl<'a> UnsafeUnpin for HeaderExtension<'a>

§

impl<'a> UnwindSafe for HeaderExtension<'a>

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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<T> ToOwned for T
where T: Clone,

Source§

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, U> TryFrom<U> for T
where U: Into<T>,

Source§

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>,

Source§

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.