Struct ZeroCopyBuffer 

pub struct ZeroCopyBuffer { /* private fields */ }

A zero-copy buffer with memory pooling

Reference counting is handled by Arc<ZeroCopyBuffer> — the internal ref_count field has been removed in favour of a single source of truth.

Implementations

impl ZeroCopyBuffer

pub fn new(capacity: usize) -> Self

Create a new zero-copy buffer with the given capacity

pub fn with_id(capacity: usize, id: u64) -> Self

Create a new zero-copy buffer with custom ID

pub fn reserve(self: &Arc<Self>, len: usize) -> Option<BufferSlice>

Get a slice of the buffer for writing. Requires an Arc reference to safely create a BufferSlice.

pub unsafe fn get_mut_slice(&self, offset: usize, len: usize) -> &mut [u8]

Get a mutable slice for the reserved range

Safety

Caller must ensure exclusive access to this range. The mutable borrow from immutable self is intentional - this is interior mutability via raw pointers with atomic coordination for lock-free access.

pub fn get_slice(&self, offset: usize, len: usize) -> &[u8]

Get an immutable slice

pub fn len(&self) -> usize

Get the current write position

pub fn is_empty(&self) -> bool

Check if buffer is empty

pub fn remaining(&self) -> usize

Get remaining capacity

pub fn capacity(&self) -> usize

Get total capacity

pub fn id(&self) -> u64

Get buffer ID

pub fn reset(&self) -> bool

Reset buffer for reuse.

Resets the write position to 0. The caller must ensure exclusive ownership (e.g. Arc::strong_count() == 1) before calling.

pub fn add_ref(&self)

👎Deprecated: Use Arc::clone instead

Compatibility shim — ref counting is now handled by Arc.

pub fn try_allocate(&self, len: usize) -> Option<usize>

Allocate len bytes and advance the write position, returning the start offset. Does NOT create a BufferSlice — the caller is expected to hold an Arc<ZeroCopyBuffer> which keeps the buffer alive.

pub fn release(&self) -> bool

👎Deprecated: Use Arc::strong_count instead

Compatibility shim — ref counting is now handled by Arc.

pub fn ref_count(&self) -> u32

👎Deprecated: Use Arc::strong_count instead

Compatibility shim — ref counting is now handled by Arc.

pub fn freeze(&self) -> Bytes

Convert entire written portion to Bytes (zero-copy if possible)

Trait Implementations

impl Debug for ZeroCopyBuffer

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

Formats the value using the given formatter.

impl Drop for ZeroCopyBuffer

fn drop(&mut self)

Executes the destructor for this type.

impl Send for ZeroCopyBuffer

impl Sync for ZeroCopyBuffer