Struct StbStringRef 

#[repr(C)]
pub struct StbStringRef {
    pub ptr: *const c_char,
    pub len: usize,
}

A borrowed, non-owning view of a string passed as an input to an FFI call. The callee MUST NOT free it and MUST NOT retain it past the call.

Built from a &str on the calling side; the buffer is valid for the duration of the call (the caller’s borrow).

Fields

ptr: *const c_char

UTF-8 bytes (valid for the call; NUL-terminated not required).

len: usize

Byte length.

Implementations

impl StbStringRef

pub const fn empty() -> Self

Empty input.

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

Borrow a &str for the duration of a call. The caller must outlive the call (normal borrow rules).

pub unsafe fn as_str<'a>(&self) -> &'a str

Read into a safe &str for the callee’s lifetime 'a.

Panics on invalid UTF-8; SDK callback trampolines contain that panic.

Safety

The caller guarantees ptr is valid for len initialized bytes in a single allocation, with len <= isize::MAX, and those bytes remain live and unchanged for the borrow’s lifetime 'a.

Trait Implementations

impl Clone for StbStringRef

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for StbStringRef

impl Send for StbStringRef

impl Sync for StbStringRef