Struct KCell 

pub struct KCell<T, Class> { /* private fields */ }

A container cell that safe-guards data of type T using type-level lock class tracking.

KCell holds data that can only be safely accessed (read or written) by proving that the corresponding mutual exclusion lock of class Class is currently held by the current thread via a LockToken.

Implementations

impl<T, Class> KCell<T, Class>

pub const fn new(value: T) -> Self

Creates a new KCell containing the specified value.

pub unsafe fn get<'b>(&self, _token: &'b LockToken<'_, Class>) -> &'b T

Access the guarded value immutably using a shared lock token.

Safety

The caller must guarantee that:

1. The provided LockToken belongs to the specific lock instance that guards this KCell (rather than a different lock of the same lock class Class).
2. The lock is held continuously for the lifetime of the returned reference 'b.

pub unsafe fn get_mut<'b>( &self, _token: &'b mut LockToken<'_, Class>, ) -> &'b mut T

Access the guarded value mutably using a mutable lock token.

Safety

The caller must guarantee that:

1. The provided LockToken belongs to the specific lock instance that guards this KCell (rather than a different lock of the same lock class Class).
2. The lock is held continuously for the lifetime of the returned reference 'b.

pub unsafe fn as_mut_ptr(&self, _token: &mut LockToken<'_, Class>) -> *mut T

Returns a mutable raw pointer to the guarded value.

Safety

The caller must guarantee that the lock instance guarding this KCell is held continuously while dereferencing or accessing the returned raw pointer.

pub fn get_inner_mut(&mut self) -> &mut T

Accesses the inner value mutably by bypassing the locking requirements using unique borrow ownership.

pub fn into_inner(self) -> T

Unwraps the cell, returning the inner value.

Trait Implementations

impl<T, Class> AsMut<T> for KCell<T, Class>

fn as_mut(&mut self) -> &mut T

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T, Class> Debug for KCell<T, Class>

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

Formats the value using the given formatter.

impl<T: Default, Class> Default for KCell<T, Class>

fn default() -> Self

Returns the “default value” for a type.

impl<T, Class> From<T> for KCell<T, Class>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T, Class, I, E> PinInit<KCell<T, Class>, E> for KCellInit<I, Class>

where I: PinInit<T, E>,

unsafe fn __pinned_init(self, slot: *mut KCell<T, Class>) -> Result<(), E>

Initializes slot.

fn pin_chain<F>(self, f: F) -> ChainPinInit<Self, F, T, E>

where F: FnOnce(Pin<&mut T>) -> Result<(), E>,

First initializes the value using self then calls the function f with the initialized value.

impl<T: Send, Class> Send for KCell<T, Class>

impl<T: Send, Class> Sync for KCell<T, Class>