Struct RbStringOwned 

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

FFI-safe owned string

Unlike RbString, this type owns its memory and must be freed by calling rb_string_free. This is used for strings returned from Rust to the host.

Memory Ownership

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

Fields

len: u32

Length in bytes (excluding null terminator)

data: *mut u8

Pointer to null-terminated UTF-8 data (Rust-owned)

capacity: u32

Allocation capacity (for proper deallocation)

Implementations

impl RbStringOwned

pub fn empty() -> Self

Create an empty owned string

pub fn from_string(s: String) -> Self

Create from a Rust String (takes ownership)

The string will be null-terminated for C compatibility.

pub fn from_slice(s: &str) -> Self

Create from a string slice (copies data)

pub fn as_borrowed(&self) -> RbString

Convert to borrowed RbString

pub unsafe fn free(&mut self)

Free the owned string

Safety

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

Trait Implementations

impl Debug for RbStringOwned

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

Formats the value using the given formatter.

impl Default for RbStringOwned

fn default() -> Self

Returns the “default value” for a type.

impl Send for RbStringOwned