Struct pebble_skip::standard_c::CStr

#[repr(transparent)]pub struct CStr<T: Storage>(_, _);

A zero-terminated UTF-8 string slice.
Note: When dereferencing this type to str, the trailing '\0' is not included.

Why this is reimplemented (aside from not being in core):

Comment on std::ffi::CStr:

// Anyway, `CStr` representation and layout are considered implementation detail, are
// not documented and must not be relied upon.

Implementations

impl<T: Storage> CStr<T>

#[must_use]pub fn as_c_str(&self) -> &c_str

#[must_use]pub fn as_c_str_mut(&mut self) -> &mut c_str

impl<T: Storage> CStr<T>

#[must_use]pub unsafe fn from_zero_terminated_unchecked(str: &str) -> &Self

Safety

As the name says, only if slice is zero-terminated and has Storage T.

#[must_use]pub unsafe fn from_zero_terminated_unchecked_mut(str: &mut str) -> &mut Self

Safety

As the name says, only if slice is zero-terminated and has Storage T.

#[must_use]pub unsafe fn from_raw_parts_mut(c_str: &mut c_str, len: usize) -> &mut Self

Safety

Only safe if c_str and len represent a valid zero-terminated UTF-8 string with Storage T.

impl CStr<Stack>

pub fn try_from_stack(str: &str) -> Result<&Self, ()>

Errors

If str doesn't end with '\0'.

impl CStr<Static>

pub fn try_from_static(str: &'static str) -> Result<&'static Self, ()>

Errors

If str doesn't end with '\0'.

#[must_use]pub unsafe fn from_static_zero_terminated_unchecked(
    str: &'static str
) -> &'static Self

Safety

Safe iff str is a zero-terminated str with static storage.

Trait Implementations

impl<T: Storage> Deref for CStr<T>

type Target = str

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Storage> DerefMut for CStr<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a> TryFrom<&'a mut str> for &'a mut CStr<Stack>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: &'a mut str) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<&'a str> for &'a CStr<Stack>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: &'a str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'static mut str> for &'static mut CStr<Static>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: &'static mut str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'static str> for &'static CStr<Static>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: &'static str) -> Result<Self, Self::Error>

Performs the conversion.