Struct PoolBuffer 

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

Fixed-Capacity Byte-Buffer, der wie Vec<u8> befuellt werden kann — aber keinen Heap-Realloc macht. Ueberlauf wird per Result gemeldet, nicht per panic!.

Layout: [u8; CAP] + len: u16 (max 65 535 Bytes pro Buffer). Fuer DDS-Hot-Path-Samples bis 1.5 kB ist das genug; groessere Samples laufen weiter ueber den alloc-Pfad.

Implementations

impl<const CAP: usize> PoolBuffer<CAP>

pub const fn new() -> Self

Erzeugt einen leeren Buffer.

CAP muss <= u16::MAX as usize sein — bei groesseren Werten lehnt jede Mutation mit PoolBufferError::CapacityTooLarge ab.

pub const fn len(&self) -> usize

Aktuelle Laenge (Bytes geschrieben).

pub const fn is_empty(&self) -> bool

true wenn keine Bytes geschrieben sind.

pub const fn capacity(&self) -> usize

Statische Kapazitaet.

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

Lesender Slice ueber die geschriebenen Bytes.

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

Mutabler Slice ueber den uninitialisierten Tail (Capacity-len).

pub fn clear(&mut self)

Setzt den Inhalt zurueck auf len = 0. O(1), kein Memzero.

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

Haengt data ans Ende. Fehler wenn der Buffer voll waere.

Errors

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

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

Schreibt ein einzelnes Byte. Fehler bei Vollheit.

Errors

PoolBufferError::Overflow wenn der Buffer voll ist.

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

Setzt die Laenge explizit. Genutzt nach einem spare_capacity_mut- Schreibzugriff durch ein Codec-Backend.

Errors

PoolBufferError::Overflow wenn 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.