Struct NullTermStr 

pub struct NullTermStr<'s> { /* private fields */ }

Similar to ffi::CStr, except that Self::from_ptr() does not implicitly perform a libc::strlen().

The stdlib docs note that this is the eventual goal for CStr, but in this case we want to control where the length measurement is performed, so that we can avoid performing it until we actually want to use the string data.

Implementations

impl<'s> NullTermStr<'s>

pub const unsafe fn from_ptr(start: *const c_char) -> Self

Wrap a null-terminated C-style string, without performing any length calculation or reading any bytes from the pointed-to value.

Safety

start must be non-null, and point to a contiguous region of memory which ends with a null byte. This is the same requirement as for ffi::CStr::from_ptr().

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

Return the input that was provided to Self::from_ptr().

pub fn measure(self) -> &'s MeasuredNullTermStr

Execute libc::strlen() to calculate the length of the pointed-to string.

pub fn match_dir_entries_unmeasured(&self) -> bool

Return whether this matches either of the always-present directory entries "." or "..".

This is performed without any call to strlen(), and will not read past the first null byte.

Trait Implementations

impl<'s> Clone for NullTermStr<'s>

fn clone(&self) -> NullTermStr<'s>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NullTermStr<'_>

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

Formats the value using the given formatter.

impl Hash for NullTermStr<'_>

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for NullTermStr<'_>

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl<'s> Copy for NullTermStr<'s>

impl Eq for NullTermStr<'_>