Struct DynamicByteBuffer 

pub struct DynamicByteBuffer { /* private fields */ }

A mutable byte buffer with Arc-based reference counting. Send but not Sync - can be moved between threads but not shared. Pool-attached buffers are returned to the pool on drop.

Implementations

impl DynamicByteBuffer

pub fn copy(&self) -> Self

Convert to an immutable StaticByteBuffer (deep copy, capacity trimmed).

pub fn to_owned(&self) -> StaticByteBuffer

Convert to an immutable StaticByteBuffer (deep copy, capacity trimmed).

pub fn before_capacity(&self) -> usize

Returns the number of bytes available for prepending before the current view.

pub fn append_buf(&self, other: &impl ByteBuffer) -> Self

Append other buffer contents to end. Returns expanded view.

pub fn prepend_buf(&self, other: &impl ByteBuffer) -> Self

Prepend other buffer contents to start. Returns expanded view.

Trait Implementations

impl AsMut<[u8]> for DynamicByteBuffer

fn as_mut(&mut self) -> &mut [u8]

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

impl AsRef<[u8]> for DynamicByteBuffer

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

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

impl ByteBuffer for DynamicByteBuffer

fn len(&self) -> usize

Returns the length of the current view in bytes.

fn get(&self, at: usize) -> &u8

Get byte at at index. Panics if out of bounds.

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

Get immutable slice of entire buffer.

fn slice_start(&self, start: usize) -> &[u8]

Get immutable slice from start offset to end.

fn slice_end(&self, end: usize) -> &[u8]

Get immutable slice from beginning to end offset.

fn slice_both(&self, start: usize, end: usize) -> &[u8]

Get immutable slice from start to end offset.

fn split(&self, divide: usize) -> (&[u8], &[u8])

Split into two immutable slices at divide point. Returns (left, right).

fn is_empty(&self) -> bool

Returns true if buffer length is zero.

impl ByteBufferMut for DynamicByteBuffer

fn set(&self, at: usize, value: u8)

Set byte at at index to value. Panics if out of bounds.

fn slice_mut(&self) -> &mut [u8]

Get mutable slice of entire buffer.

fn slice_start_mut(&self, start: usize) -> &mut [u8]

Get mutable slice from start offset to end.

fn slice_end_mut(&self, end: usize) -> &mut [u8]

Get mutable slice from beginning to end offset.

fn slice_both_mut(&self, start: usize, end: usize) -> &mut [u8]

Get mutable slice from start to end offset.

fn split_mut(&self, divide: usize) -> (&mut [u8], &mut [u8])

Split into two mutable slices at divide point. Returns (left, right).

fn rebuffer_start(&self, start: usize) -> Self

Create view with start shifted forward by start bytes.

fn rebuffer_end(&self, end: usize) -> Self

Create view with end at end offset from current start.

fn rebuffer_both(&self, start: usize, end: usize) -> Self

Create view with both start and end adjusted from current start.

fn expand_start(&self, size: usize) -> Self

Expand view backward by size bytes (into header space).

fn expand_end(&self, size: usize) -> Self

Expand view forward by size bytes (into trailer space).

fn split_buf_start(&self, divide: usize) -> (Self, Self)

Split into two buffer views at divide point. Returns (left, right).

fn split_buf_end(&self, divide: usize) -> (Self, Self)

Split into two buffer views at len(buffer) - divide point. Returns (left, right).

fn append(&self, other: &[u8]) -> Self

Append other slice to end. Returns expanded view.

fn prepend(&self, other: &[u8]) -> Self

Prepend other slice to start. Returns expanded view.

fn ensure_size(&self, size: usize) -> Self

Ensure buffer has at least size bytes, expanding or shrinking as needed.

impl Clone for DynamicByteBuffer

fn clone(&self) -> Self

Zero-copy clone: increments the Arc<BufferHolder> refcount and produces a second view into the same backing allocation.

Aliasing invariant

Both the original and the clone share the same raw memory. The caller must ensure that no two live mutable views (via slice_mut, set, etc.) to overlapping byte ranges are used concurrently — including across threads, since DynamicByteBuffer: Send. Non-overlapping views (e.g. produced by split_buf_start/split_buf_end) may be used independently.

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

Performs copy-assignment from source.

impl Debug for DynamicByteBuffer

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

Formats the value using the given formatter.

impl Fill for DynamicByteBuffer

fn try_fill<R: Rng + ?Sized>(&mut self, rng: &mut R) -> Result<(), Error>

Fill self with random data

impl<const N: usize> From<&DynamicByteBuffer> for [u8; N]

fn from(val: &DynamicByteBuffer) -> Self

Converts to this type from the input type.

impl From<DynamicByteBuffer> for Vec<u8>

fn from(val: DynamicByteBuffer) -> Self

Converts to this type from the input type.

impl PartialEq for DynamicByteBuffer

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.