Struct UStr

pub struct UStr { /* private fields */ }

UTF-8 string that does not contain nul values, and is stored with nul termination for easy conversion to CStr.

This string is valid even when Arena is dropped, because it holds a weak arena reference which does not return memory back to Memory as long as it is alive. That said, make sure to drop all these strings to reclaim the memory.

Implementations

impl UStr

pub fn from_cstr(arena: &Arena, value: &CStr) -> Result<UStr, UStrError>

Initialize from &CStr.

pub fn from_trusted_cstr_ptr( arena: &Arena, bytes: *const i8, ) -> Result<UStr, UStrError>

Initialize from char* which comes from a trusted source.

pub fn from_str(arena: &Arena, value: &str) -> Result<UStr, UStrError>

Initialize from &str.

pub fn as_ptr(&self) -> *const i8

Get pointer to char*.

Trait Implementations

impl AsRef<CStr> for UStr

fn as_ref(&self) -> &CStr

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

impl AsRef<str> for UStr

fn as_ref(&self) -> &str

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

impl Clone for UStr

fn clone(&self) -> UStr

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UStr

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

Formats the value using the given formatter.

impl Display for UStr

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

Formats the value using the given formatter.

impl PartialEq<UStr> for CStr

fn eq(&self, other: &UStr) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<UStr> for CString

fn eq(&self, other: &UStr) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<UStr> for String

fn eq(&self, other: &UStr) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<UStr> for str

fn eq(&self, other: &UStr) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for UStr

fn eq(&self, other: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for UStr

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for UStr