Struct BorrowedStr 

pub struct BorrowedStr<'a> {
    pub ptr: *const u8,
    pub len: usize,
    /* private fields */
}

A borrowed UTF-8 string with a lifetime tied to the producer’s storage.

Use this for 'static strings baked into a plug-in’s manifest (type names, version strings). The host reads through the pointer while the producing library is loaded; in v1 that is the process lifetime, since plug-ins are not unloaded.

Fields

ptr: *const u8

len: usize

Implementations

impl<'a> BorrowedStr<'a>

pub const fn empty() -> Self

Returns an empty borrowed string.

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

Wraps a Rust string slice as a borrowed boundary string.

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

Converts the borrowed string back to a &str.

Safety

The caller must ensure the producing storage is still live and the bytes are valid UTF-8.

Trait Implementations

impl<'a> Clone for BorrowedStr<'a>

fn clone(&self) -> BorrowedStr<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for BorrowedStr<'a>

impl Debug for BorrowedStr<'_>

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

Formats the value using the given formatter.

impl Send for BorrowedStr<'_>

SAFETY: BorrowedStr is just a pointer + length; sending it across threads is sound as long as the underlying storage outlives the use. In v1 the storage is process-lifetime static memory in the producing library.

impl Sync for BorrowedStr<'_>

SAFETY: see Send impl.