Struct NrStr 

#[repr(C)]
pub struct NrStr {
    pub ptr: *const u8,
    pub len: u32,
    pub _reserved: u32,
}

A UTF-8 string slice with a pointer and length. This struct is #[repr(C)] and ABI-stable.

On 64-bit targets _reserved occupies the four bytes after len that would otherwise be implicit padding. Producers must set it to zero.

Fields

ptr: *const u8

len: u32

_reserved: u32

Implementations

impl NrStr

pub fn new(s: &str) -> Self

Creates a borrowed ABI string view.

The returned value must not be used to access the string after s is invalidated. Use NrStr::as_str only while the source is alive.

pub const fn from_static(s: &'static str) -> Self

Creates a borrowed ABI view from a static string.

pub unsafe fn as_str<'a>(&self) -> Result<&'a str, NrViewError>

Reads this ABI view as UTF-8.

Safety

For a non-empty view, ptr must be valid for reads of len bytes for the lifetime of the returned reference. The pointed-to memory must not be mutated while that reference exists.

pub unsafe fn as_bytes<'a>(&self) -> Result<&'a [u8], NrViewError>

Reads this ABI view’s raw bytes without validating UTF-8.

Safety

For a non-empty view, ptr must be valid for reads of len bytes for the lifetime of the returned reference. The pointed-to memory must not be mutated while that reference exists.

pub const fn is_empty(&self) -> bool

Returns whether this view contains no bytes.

pub const fn len(&self) -> usize

Returns the view length in bytes.

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

Returns the underlying raw pointer.

pub fn clear(&mut self)

Resets this view without freeing the borrowed memory.

Trait Implementations

impl Clone for NrStr

fn clone(&self) -> NrStr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for NrStr

impl Debug for NrStr

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

Formats the value using the given formatter.

impl Default for NrStr

fn default() -> NrStr

Returns the “default value” for a type.

impl Send for NrStr

impl Sync for NrStr