Struct MaaStringListBuffer 

pub struct MaaStringListBuffer { /* private fields */ }

A list buffer for storing multiple strings.

Provides indexed access and iteration over a collection of UTF-8 strings.

Implementations

impl MaaStringListBuffer

pub fn new() -> MaaResult<Self>

Create a new buffer.

pub unsafe fn from_raw(handle: *mut MaaStringListBuffer) -> 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 MaaStringListBuffer) -> Option<Self>

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

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

Get the underlying raw handle.

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

Get the underlying raw handle (alias for as_ptr).

impl MaaStringListBuffer

pub fn len(&self) -> usize

Returns the number of strings in the list.

pub fn is_empty(&self) -> bool

Returns true if the list contains no strings.

pub fn append(&self, s: &str) -> MaaResult<()>

Appends a string to the end of the list.

pub fn set<S: AsRef<str>>(&self, data: &[S]) -> MaaResult<()>

Set the content of this list, replacing existing content.

pub fn remove(&self, index: usize) -> MaaResult<()>

Removes the string at the specified index.

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

Removes all strings from the list.

pub fn iter(&self) -> impl Iterator<Item = &str> + '_

Get an iterator over the strings in the list.

The iterator yields &str slices borrowing from the buffer. This is zero-cost and safe.

pub fn to_vec(&self) -> Vec<String>

Collects all strings into a Vec<String>.

Trait Implementations

impl Debug for MaaStringListBuffer

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

Formats the value using the given formatter.

impl Default for MaaStringListBuffer

fn default() -> Self

Returns the “default value” for a type.

impl Drop for MaaStringListBuffer

fn drop(&mut self)

Executes the destructor for this type.

impl Send for MaaStringListBuffer