Struct safer_ffi::char_p::char_p_ref

#[repr(transparent)]pub struct char_p_ref<'lt>(_, _);

A #[repr(c)] null-terminated UTF-8 encoded string, for compatibility with both the C char * API and Rust's str.

This is a borrowed version, i.e., with the semantics of &'lt CStr / &'lt str, but for it being a slim pointer.

C Layout

• ptr::NonNullRef<c_char>

Implementations

impl char_p_ref<'static>

pub const EMPTY: Self

impl<'lt> char_p_ref<'lt>

pub const unsafe fn from_ptr_unchecked(ptr: NonNull<u8>) -> Self

impl<'lt> char_p_ref<'lt>

pub fn bytes(self: char_p_ref<'lt>) -> impl Iterator<Item = NonZeroU8> + 'lt

pub fn to_nonzero_bytes(self: char_p_ref<'lt>) -> &'lt [NonZeroU8]

pub fn to_bytes(self: char_p_ref<'lt>) -> &'lt [u8]

pub fn to_bytes_with_null(self: char_p_ref<'lt>) -> &'lt [u8]

pub fn to_str(self: char_p_ref<'lt>) -> &'lt str

pub fn to_str_with_null(self: char_p_ref<'lt>) -> &'lt str

pub fn to_owned(self: char_p_ref<'lt>) -> char_p_boxed

This is supported on feature="alloc" only.

Trait Implementations

impl<'lt> Clone for char_p_ref<'lt>

fn clone(&self) -> char_p_ref<'lt>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'lt> Copy for char_p_ref<'lt>

impl<'_> Debug for char_p_ref<'_>

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'_> Display for char_p_ref<'_>

fn fmt(&self, fmt: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<'lt> Eq for char_p_ref<'lt>

impl<'lt> From<&'lt CStr> for char_p_ref<'lt>

Panic

Panics if the CStr is not valid UTF-8.

fn from(s: &'lt CStr) -> char_p_ref<'lt>

Performs the conversion.

impl<'lt> From<char_p_ref<'lt>> for char_p_raw

fn from(it: char_p_ref<'lt>) -> char_p_raw

Performs the conversion.

impl<'lt> PartialEq<char_p_ref<'lt>> for char_p_ref<'lt>

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<'lt> ReprC for char_p_ref<'lt> where
    NonNullRef<c_char>: ReprC, 

type CLayout = <NonNullRef<c_char> as ReprC>::CLayout

The CType having the same layout as Self.

fn is_valid(it: &Self::CLayout) -> bool

Sanity checks that can be performed on an instance of the CType layout.

impl<'lt> TryFrom<&'lt str> for char_p_ref<'lt>

type Error = InvalidNulTerminator<()>

The type returned in the event of a conversion error.

fn try_from(s: &'lt str) -> Result<char_p_ref<'lt>, InvalidNulTerminator<()>>

Performs the conversion.