Enum SharedFrame 

pub enum SharedFrame {
    Owned(Vec<u8>),
    Shared(Arc<Vec<u8>>),
}

A raw-bytes frame that may be shared (zero-copy) or exclusively owned.

Adjacent nodes that produce and consume the same format can pass a SharedFrame::Shared variant through the graph; the receiving node reads the bytes via SharedFrame::as_bytes without any memcpy. When a node must mutate the payload it calls SharedFrame::into_owned, which clones the bytes only when there is more than one live Arc reference.

Variants

Owned(Vec<u8>)

Exclusively-owned byte buffer.

Shared(Arc<Vec<u8>>)

Reference-counted (shared) byte buffer — zero-copy on the read path.

Implementations

impl SharedFrame

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

Borrow the underlying bytes regardless of ownership variant.

pub fn into_owned(self) -> Vec<u8>

Consume into an exclusively-owned Vec<u8>.

• Owned — free, no allocation.
• Shared with a unique reference — moves the inner Vec out of the Arc without copying.
• Shared with multiple references — clones the bytes once.

pub fn try_share(&self) -> Arc<Vec<u8>>

Return an Arc<Vec<u8>> that points at the same allocation as self.

• Shared — clones the Arc (O(1), no heap allocation).
• Owned — wraps the buffer in a new Arc (one allocation, O(1)).

pub fn promote(self) -> Self

Promote an Owned frame to Shared, consuming self.

If already Shared, returns self unchanged.

pub fn is_shared(&self) -> bool

Returns true if this is the Shared variant.

pub fn is_owned(&self) -> bool

Returns true if this is the Owned variant.

Trait Implementations

impl Clone for SharedFrame

fn clone(&self) -> SharedFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedFrame

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

Formats the value using the given formatter.

impl From<Arc<Vec<u8>>> for SharedFrame

fn from(arc: Arc<Vec<u8>>) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for SharedFrame

fn from(v: Vec<u8>) -> Self

Converts to this type from the input type.