Struct swiss_army_knife::strings::NulTerminatedCStringArray

pub struct NulTerminatedCStringArray { /* fields omitted */ }

An array of c strings (nul terminated byte arrays) with a final nul.

buffer contains a list of NUL-terminated C strings, each with a terminating NUL, before terminating the entire list with NUL (ie there are two NUL bytes at the end). pointers points to C strings in buffer, with a final pointer of null().

NOTE: Empty strings are allowed, but, if using only the buffer, they can not be discovered simply by walking the buffer’s bytes.

Implementations

impl NulTerminatedCStringArray

pub fn new<'a>(
    c_strings_as_fragments_to_combine: impl Iterator<Item = impl CStringFragments>,
    page_size: impl Into<usize>
) -> Self

c_string_components provides the pieces that are to create a CString.

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

Array of pointers.

pub fn as_block_of_strings(&self, preserve_final_nul_if_empty: bool) -> &[u8]

Buffer, suitable for /proc/<pid>/environ and /proc/<pid>/cmdline if preserve_final_nul_if_empty is false.

Trait Implementations

impl Clone for NulTerminatedCStringArray

fn clone(&self) -> NulTerminatedCStringArray

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NulTerminatedCStringArray

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

Formats the value using the given formatter.

impl Eq for NulTerminatedCStringArray

impl Hash for NulTerminatedCStringArray

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Ord for NulTerminatedCStringArray

fn cmp(&self, other: &NulTerminatedCStringArray) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<NulTerminatedCStringArray> for NulTerminatedCStringArray

fn eq(&self, other: &NulTerminatedCStringArray) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<NulTerminatedCStringArray> for NulTerminatedCStringArray

fn partial_cmp(&self, other: &NulTerminatedCStringArray) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for NulTerminatedCStringArray

impl StructuralPartialEq for NulTerminatedCStringArray