Struct memur::UStr

pub struct UStr { /* fields omitted */ }

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

Performs the conversion.

impl AsRef<str> for UStr

fn as_ref(&self) -> &str

Performs the conversion.

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 Eq for UStr

impl PartialEq<UStr> for UStr

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<UStr> for str

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<UStr> for String

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<UStr> for CStr

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<UStr> for CString

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<str> for UStr

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.