Struct ExposedDecodedArray 

pub struct ExposedDecodedArray<const CAP: usize> { /* private fields */ }

Owned stack array extracted from DecodedBuffer.

This wrapper keeps the extracted decoded bytes on the crate’s best-effort drop-time cleanup path. Use Self::into_exposed_unprotected_array_caller_must_zeroize only when a bare array is unavoidable and the caller will handle cleanup.

Implementations

impl<const CAP: usize> ExposedDecodedArray<CAP>

pub const fn from_array(bytes: [u8; CAP], len: usize) -> Self

Wraps a decoded backing array and visible length.

Panics

Panics if len is greater than CAP.

pub fn as_bytes(&self) -> &[u8]

Returns the visible decoded bytes.

pub const fn len(&self) -> usize

Returns the number of visible decoded bytes.

pub const fn is_empty(&self) -> bool

Returns whether there are no visible decoded bytes.

pub const fn capacity(&self) -> usize

Returns the backing array capacity.

pub fn into_exposed_unprotected_array_caller_must_zeroize( self, ) -> ([u8; CAP], usize)

Consumes the wrapper and returns a bare array plus visible length.

This is an unprotected escape hatch. The returned array will not be cleared by this crate on drop. Callers must clear it with their own approved zeroization policy.

Security

Treat this as a cleanup-boundary API. Failing to clear the returned array leaves decoded bytes, which may be secret-bearing, in ordinary caller-owned memory until overwritten by later stack or heap activity.

Trait Implementations

impl<const CAP: usize> Debug for ExposedDecodedArray<CAP>

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

Formats the value using the given formatter.

impl<const CAP: usize> Drop for ExposedDecodedArray<CAP>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.