Struct Buffer 

pub struct Buffer<T: Clone> { /* private fields */ }

A reference-counted buffer with copy-on-write semantics.

Internally backed by Rc<RefCell<Vec<T>>>. When multiple Buffers share the same underlying storage, a mutation via Buffer::set or Buffer::make_unique triggers a deep copy so that other holders are unaffected.

Implementations

impl<T: Clone> Buffer<T>

pub fn alloc(len: usize, default: T) -> Self

Allocate a buffer of len elements, each initialized to default.

pub fn from_vec(data: Vec<T>) -> Self

Create a buffer from an existing Vec<T>.

pub fn len(&self) -> usize

Number of elements in the buffer.

pub fn is_empty(&self) -> bool

Whether the buffer is empty.

pub fn get(&self, idx: usize) -> Option<T>

Read the value at idx. Returns None if out of bounds.

pub fn set(&mut self, idx: usize, val: T) -> Result<(), RuntimeError>

Write val at idx. If the buffer is shared (refcount > 1), a deep copy is performed first (COW). Returns Err if idx is out of bounds.

pub fn as_slice(&self) -> Vec<T>

Return a snapshot of the data as a Vec<T>.

pub fn borrow_data(&self) -> Ref<'_, Vec<T>>

Borrow the underlying Vec without cloning. The returned Ref guard keeps the borrow alive.

pub fn clone_buffer(&self) -> Buffer<T>

Force a deep copy, returning a new Buffer that does not share storage with self.

pub fn make_unique(&mut self)

Ensure this Buffer has exclusive ownership of the underlying data. If the refcount is > 1, the data is deep-copied and this Buffer is re-pointed to the fresh copy.

pub fn refcount(&self) -> usize

Number of live references to the underlying storage.

Trait Implementations

impl<T: Clone> Clone for Buffer<T>

fn clone(&self) -> Self

Cloning a Buffer increments the refcount — it does NOT copy data.

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

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for Buffer<T>

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

Formats the value using the given formatter.