Struct safer_ffi::slice::slice_raw

#[repr(C)]pub struct slice_raw<T> {
    pub ptr: NonNull<T>,
    pub len: usize,
}

Like slice_ref and slice_mut, but with any lifetime attached whatsoever.

It is only intended to be used as the parameter of a callback that locally borrows it, due to limitations of the [ReprC][ trait@crate::layout::ReprC] design w.r.t. higher-rank trait bounds.

C layout (for some given type T)

typedef struct {
    // Cannot be NULL
    T * ptr;
    size_t len;
} slice_T;

Nullable pointer?

If you want to support the above typedef, but where the ptr field is allowed to be NULL (with the contents of len then being undefined) use the Option< slice_ptr<_> > type.

C Layout

• slice_raw_Layout

Fields

ptr: NonNull<T>

Pointer to the first element (if any).

len: usize

Element count

Implementations

impl<T> slice_raw<T>

pub unsafe fn as_ref<'borrow>(
    self: &'borrow slice_raw<T>
) -> slice_ref<'borrow, T>

Safety

• For the duration of the 'borrow, the pointer must point to the beginning of a valid and immutable null-terminated slice of len Ts.

pub unsafe fn as_mut<'borrow>(
    self: &'borrow mut slice_raw<T>
) -> slice_mut<'borrow, T>

Safety

• For the duration of the 'borrow, the pointer must point to the beginning of a valid and immutable null-terminated slice of len Ts.

Trait Implementations

impl<T: Debug> Debug for slice_raw<T>

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

Formats the value using the given formatter.

impl<'lt, T: 'lt> From<slice_mut<'lt, T>> for slice_raw<T>

fn from(slice_mut { ptr: ptr, len: len, .. }: slice_mut<'lt, T>) -> slice_raw<T>

Performs the conversion.

impl<'lt, T: 'lt> From<slice_ref<'lt, T>> for slice_raw<T>

fn from(slice_ref { ptr: ptr, len: len, .. }: slice_ref<'lt, T>) -> slice_raw<T>

Performs the conversion.

impl<T> ReprC for slice_raw<T> where
    NonNull<T>: ReprC,
    <NonNull<T> as ReprC>::CLayout: CType<OPAQUE_KIND = Concrete>,
    usize: ReprC,
    <usize as ReprC>::CLayout: CType<OPAQUE_KIND = Concrete>,
    T: ReprC, 

type CLayout = slice_raw_Layout<T>

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.