Struct MaaStringBuffer 

pub struct MaaStringBuffer { /* private fields */ }

A string buffer for UTF-8 text data.

Used for passing strings between Rust and the C API. Automatically freed when dropped.

Implementations

impl MaaStringBuffer

pub fn new() -> MaaResult<Self>

Create a new buffer.

pub unsafe fn from_raw(handle: *mut MaaStringBuffer) -> Self

Create from an existing handle.

Safety

This function assumes the handle is valid. The returned buffer will NOT take ownership of the handle (it won’t be destroyed on drop). Use this when you are borrowing a handle from the C API.

pub fn from_handle(handle: *mut MaaStringBuffer) -> Option<Self>

Create from an existing handle safely (checks for null). Returns None if handle is null.

pub fn as_ptr(&self) -> *mut MaaStringBuffer

Get the underlying raw handle.

pub fn raw(&self) -> *mut MaaStringBuffer

Get the underlying raw handle (alias for as_ptr).

impl MaaStringBuffer

pub fn set<S: AsRef<str>>(&mut self, content: S) -> MaaResult<()>

Set the buffer content from a string.

pub fn set_ex<B: AsRef<[u8]>>(&mut self, content: B) -> MaaResult<()>

Set the buffer content from raw bytes (zero-copy if possible).

This uses MaaStringBufferSetEx which accepts a length, allowing passing bytes without explicit null termination if the API supports it.

pub fn as_str(&self) -> &str

Get the buffer content as a string slice.

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

Get the buffer content as a byte slice.

pub fn is_empty(&self) -> bool

Check if the buffer is empty.

pub fn clear(&mut self) -> MaaResult<()>

Clear the buffer.

pub fn len(&self) -> usize

Get the size of the buffer content (excluding null terminator).

Trait Implementations

impl AsRef<str> for MaaStringBuffer

fn as_ref(&self) -> &str

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

impl Debug for MaaStringBuffer

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

Formats the value using the given formatter.

impl Default for MaaStringBuffer

fn default() -> Self

Returns the “default value” for a type.

impl Display for MaaStringBuffer

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

Formats the value using the given formatter.

impl Drop for MaaStringBuffer

fn drop(&mut self)

Executes the destructor for this type.

impl From<&str> for MaaStringBuffer

fn from(s: &str) -> Self

Converts to this type from the input type.

impl Send for MaaStringBuffer