Struct MonoString 

pub struct MonoString(/* private fields */);

An opaque handle to a Mono runtime object.

Thread safety

This type is intentionally !Send + !Sync. Every thread that reads or writes Mono objects must first be registered with the runtime via crate::MonoThreadGuard::attach. Using a handle on an unregistered thread is undefined behavior — Mono’s garbage collector and internal bookkeeping assume all active threads are known to the runtime.

Handles are therefore bound to the thread on which they were obtained. The compiler enforces this: a handle cannot be moved to another thread without explicit unsafe code.

If you need to transfer a handle across thread boundaries and you can guarantee that both threads are attached to the runtime for the entire duration of use, you can opt in manually on your wrapper type:

struct MyComponent {
    class: mono_rt::MonoClass,
}

// SAFETY: `class` is only accessed while the calling thread holds a
// `MonoThreadGuard`, ensuring it is registered with the Mono runtime.
unsafe impl Send for MyComponent {}
unsafe impl Sync for MyComponent {}

Implementations

impl MonoString

pub fn as_ptr(self) -> *mut c_void

pub fn from_ptr(ptr: *mut c_void) -> Option<Self>

pub unsafe fn from_ptr_unchecked(ptr: *mut c_void) -> Self

Safety

ptr must be non-null and valid on a thread attached to the Mono runtime.

impl MonoString

pub fn new(domain: MonoDomain, text: &str) -> Result<Option<Self>>

Creates a new Mono string from a Rust string slice in the given domain.

Errors

Returns MonoError::NullByteInName if text contains an interior null byte. Returns MonoError::Uninitialized if the Mono API has not been initialized.

pub fn to_string_lossy(self) -> Result<String>

Converts this Mono string to a Rust String, replacing invalid UTF-8 sequences.

Returns an empty string if the underlying pointer is null after conversion.

Errors

Returns MonoError::Uninitialized if the Mono API has not been initialized.

Trait Implementations

impl Clone for MonoString

fn clone(&self) -> MonoString

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MonoString

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

Formats the value using the given formatter.

impl Copy for MonoString