Struct RbBytesOwned 

#[repr(C)]
pub struct RbBytesOwned {
    pub len: u32,
    pub data: *mut u8,
    pub capacity: u32,
}

FFI-safe owned byte buffer

Unlike RbBytes, this type owns its memory and must be freed by calling rb_bytes_free. This is used for binary data returned from Rust to the host.

Memory Ownership

• Memory is allocated by Rust
• Must be freed by calling rb_bytes_free
• Do NOT free with host language’s free()

Fields

len: u32

Length in bytes

data: *mut u8

Pointer to binary data (Rust-owned)

capacity: u32

Allocation capacity (for proper deallocation)

Implementations

impl RbBytesOwned

pub fn empty() -> Self

Create an empty owned byte buffer

pub fn from_vec(v: Vec<u8>) -> Self

Create from a Vec (takes ownership)

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

Create from a byte slice (copies data)

pub fn as_borrowed(&self) -> RbBytes

Convert to borrowed RbBytes

pub unsafe fn free(&mut self)

Free the owned bytes

Safety

• Must only be called once
• Must only be called on buffers created by Rust

Trait Implementations

impl Debug for RbBytesOwned

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

Formats the value using the given formatter.

impl Default for RbBytesOwned

fn default() -> Self

Returns the “default value” for a type.

impl Send for RbBytesOwned