Struct PoolBuffer 

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

Fixed-capacity byte buffer that can be filled like Vec<u8> — but does not do a heap realloc. Overflow is reported via Result, not via panic!.

Layout: [u8; CAP] + len: u16 (max 65 535 bytes per buffer). This is enough for DDS hot-path samples up to 1.5 kB; larger samples continue to go through the alloc path.

Implementations

impl<const CAP: usize> PoolBuffer<CAP>

pub const fn new() -> Self

Creates an empty buffer.

CAP must be <= u16::MAX as usize — for larger values every mutation is rejected with PoolBufferError::CapacityTooLarge.

pub const fn len(&self) -> usize

Current length (bytes written).

pub const fn is_empty(&self) -> bool

true when no bytes have been written.

pub const fn capacity(&self) -> usize

Static capacity.

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

Read-only slice over the written bytes.

pub fn spare_capacity_mut(&mut self) -> &mut [u8]

Mutable slice over the uninitialized tail (capacity − len).

pub fn clear(&mut self)

Resets the contents to len = 0. O(1), no memzero.

pub fn extend_from_slice(&mut self, data: &[u8]) -> Result<(), PoolBufferError>

Appends data to the end. Errors if the buffer would be full.

Errors

PoolBufferError::Overflow when self.len() + data.len() > CAP. PoolBufferError::CapacityTooLarge when CAP > u16::MAX.

pub fn push(&mut self, byte: u8) -> Result<(), PoolBufferError>

Writes a single byte. Errors when full.

Errors

PoolBufferError::Overflow when the buffer is full.

pub fn set_len(&mut self, new_len: usize) -> Result<(), PoolBufferError>

Sets the length explicitly. Used after a spare_capacity_mut write access by a codec backend.

Errors

PoolBufferError::Overflow when new_len > CAP.

Trait Implementations

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

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

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

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.