Struct Buffer 

pub struct Buffer { /* private fields */ }

Reference-counted byte buffer with copy-on-write semantics.

Based on FFmpeg’s AVBuffer model:

• Shared via Arc (reference counting)
• make_writable() copies only if shared (CoW)
• All allocations include SIMD padding initialized to zero
• Data is 64-byte aligned for SIMD operations

Implementations

impl Buffer

pub fn new(size: usize) -> Self

Create a new buffer of the given size, zero-initialized with SIMD padding.

pub fn from_slice(data: &[u8]) -> Self

Create a buffer from existing data. Padding is appended.

pub fn size(&self) -> usize

Get the logical size of the buffer (excluding padding).

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

Get an immutable slice of the buffer data (excluding padding).

pub fn is_writable(&self) -> bool

Returns true if this is the only reference to the underlying data.

pub fn make_writable(&mut self)

Ensure the buffer is writable (CoW). If shared, creates a copy.

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

Get a mutable slice of the buffer data (excluding padding). Panics if the buffer is shared — call make_writable() first.

pub fn resize(&mut self, new_size: usize)

Resize the buffer. If growing, new bytes are zero-initialized. Panics if the buffer is shared.

Trait Implementations

impl Clone for Buffer

fn clone(&self) -> Buffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Buffer

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

Formats the value using the given formatter.