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_string(&self) -> String

Available on crate feature alloc only.

Poor-man’s specialization of ToString::to_string()

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

Available on crate 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 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> From<&'lt CStr> for char_p_ref<'lt>

Available on crate feature std only.

Panic

Panics if the CStr is not valid UTF-8.

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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 ==.

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

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

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.

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

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

impl Send for char_p_ref<'_>where for<'lt> &'lt [u8]: Send,

impl Sync for char_p_ref<'_>where for<'lt> &'lt [u8]: Sync,