Struct CStrPtr 

pub struct CStrPtr(/* private fields */);

Simple wrapper to treat a raw pointer to an array of C-style strings as a AsCStrArray

This is useful for passing raw pointers obtained from other sources (e.g., FFI) to functions that expect an AsCStrArray. However, it is the caller’s responsibility to ensure that the pointer validly points to a null-terminated array of pointers to valid C-style strings, and that the array and strings remain valid for the required lifetime. This wrapper does not take ownership of the array or strings.

You should prefer BorrowedCStrs or OwnedCStrs over this type when possible, as they provide ownership and lifetime guarantees for the strings.

Implementations

impl CStrPtr

pub unsafe fn new(ptr: *const *const c_char) -> Self

Create a new CStrPtr from a raw pointer to an array of C-style strings.

The given pointer is directly returned by the as_ptr method.

Safety

The caller must ensure that ptr points to a valid null-terminated array of pointers to valid C-style strings. The array and strings must remain valid and unmodified until the CStrPtr is dropped.

Trait Implementations

impl AsCStrArray for CStrPtr

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

Returns a pointer to the array of C-style strings.

fn as_mut_ptr(&mut self) -> *const *mut c_char

Returns a pointer to the array of C-style strings.

fn to_vec(&self) -> Vec<CString>

Constructs a Vec<CString> from the array of C-style strings.

impl Clone for CStrPtr

fn clone(&self) -> CStrPtr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CStrPtr

impl Debug for CStrPtr

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

Formats the value using the given formatter.

impl Eq for CStrPtr

impl Hash for CStrPtr

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

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 Ord for CStrPtr

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for CStrPtr

fn eq(&self, other: &CStrPtr) -> 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 PartialOrd for CStrPtr

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl StructuralPartialEq for CStrPtr