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.

pub unsafe fn try_as_str(&self) -> Result<&'a str, Utf8Error>

Converts the borrowed string to a &str, validating UTF-8.

Use this at trust boundaries where the producer’s UTF-8 commitment should be verified rather than assumed.

Errors

Returns an error when the bytes are not valid UTF-8.

Safety

The caller must ensure the producing storage is still live.

pub unsafe fn to_string_lossy(&self) -> String

Converts the borrowed string to an owned String, replacing invalid UTF-8 sequences with the replacement character.

Safety

The caller must ensure the producing storage is still live.

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.