Struct EncodedBuffer 

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

Stack-backed encoded Base64 output.

This type is intended for short values where heap allocation would be unnecessary but manually sizing and passing a separate output slice is noisy. Its visible bytes are produced by crate encoders, so Self::as_str can return &str without exposing a fallible UTF-8 conversion to callers.

The backing array is cleared when the value is dropped. This is best-effort data-retention reduction and is not a formal zeroization guarantee.

Implementations

impl<const CAP: usize> EncodedBuffer<CAP>

pub const fn new() -> Self

Creates an empty encoded buffer.

pub const fn len(&self) -> usize

Returns the number of visible encoded bytes.

pub const fn is_empty(&self) -> bool

Returns whether the buffer has no visible encoded bytes.

pub const fn capacity(&self) -> usize

Returns the stack capacity in bytes.

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

Returns the visible encoded bytes.

pub fn as_str(&self) -> &str

Returns the visible encoded bytes as UTF-8.

Panics

Panics only if the crate’s internal invariant is broken and the buffer contains non-UTF-8 bytes.

pub fn clear(&mut self)

Clears the visible bytes and the full backing array.

pub fn clear_tail(&mut self)

Clears bytes after the visible prefix.

Trait Implementations

impl<const CAP: usize> AsRef<[u8]> for EncodedBuffer<CAP>

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

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

impl<const CAP: usize> Clone for EncodedBuffer<CAP>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<const CAP: usize> Default for EncodedBuffer<CAP>

fn default() -> Self

Returns the “default value” for a type.

impl<const CAP: usize> Drop for EncodedBuffer<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.

impl<const CAP: usize> PartialEq for EncodedBuffer<CAP>

fn eq(&self, other: &Self) -> 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<const CAP: usize> Eq for EncodedBuffer<CAP>