Struct CList 

pub struct CList<T, const OFFSET: usize>(/* private fields */);

A typed C linked list with a sentinel head intended for FFI use-cases where a C subsystem manages a linked list that Rust code needs to read. Generally required only for special cases.

A sentinel head CListHead represents the entire linked list and can be used for iteration over items of type T; it is not associated with a specific item.

The const generic OFFSET specifies the byte offset of the list_head field within the struct that T wraps.

Invariants

• The sentinel CListHead has valid non-NULL next/prev pointers.
• OFFSET is the byte offset of the list_head field within the struct that T wraps.
• All the list’s list_head nodes have valid non-NULL next/prev pointers.

Implementations

impl<T, const OFFSET: usize> CList<T, OFFSET>

pub unsafe fn from_raw<'a>(ptr: *mut list_head) -> &'a Self

Create a typed CList reference from a raw sentinel list_head pointer.

Safety

• ptr must be a valid pointer to an initialized sentinel list_head (e.g. via INIT_LIST_HEAD()), with valid non-NULL next/prev pointers.
• ptr must remain valid for the lifetime 'a.
• The list and all linked nodes must not be concurrently modified for the lifetime 'a.
• The list must contain items where the list_head field is at byte offset OFFSET.
• T must be #[repr(transparent)] over the C struct.

pub fn is_empty(&self) -> bool

Check if the list is empty.

pub fn iter(&self) -> CListIter<'_, T, OFFSET>

Create an iterator over typed items.