Struct SharedContainer

pub struct SharedContainer<T: Debug> { /* private fields */ }

A unified container for shared data that works in both multi-threaded and single-threaded environments.

This struct provides an abstraction over Arc<RwLock<T>> (used in multi-threaded environments) and Rc<RefCell<T>> (used in single-threaded environments like WebAssembly).

It allows code to be written once but compile to the most efficient implementation based on the environment where it will run.

Implementations

impl<T: Debug + Clone> SharedContainer<T>

pub fn get_cloned(&self) -> Option<T>

Gets a clone of the contained value.

This method acquires a read lock, clones the value, and releases the lock.

Returns

• Some(T): A clone of the contained value
• None: If the lock couldn’t be acquired

impl<T: Debug> SharedContainer<T>

pub fn new(value: T) -> Self

Creates a new SharedContainer containing the given value.

Parameters

• value: The value to store in the container

Returns

A new SharedContainer instance containing the value

pub fn read(&self) -> Option<SharedReadGuard<'_, T>>

Gets a read-only access guard to the contained value.

Returns

• Some(SharedReadGuard<T>): A guard allowing read-only access to the value
• None: If the lock couldn’t be acquired (in multi-threaded mode)

pub fn write(&self) -> Option<SharedWriteGuard<'_, T>>

Gets a writable access guard to the contained value.

Returns

• Some(SharedWriteGuard<T>): A guard allowing read-write access to the value
• None: If the lock couldn’t be acquired (in multi-threaded mode)

pub fn downgrade(&self) -> WeakSharedContainer<T>

Creates a weak reference to this container.

A weak reference doesn’t prevent the value from being dropped when no strong references remain, which helps break reference cycles that could cause memory leaks.

Returns

A WeakSharedContainer that points to the same data

Trait Implementations

impl<T: Debug> Clone for SharedContainer<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Debug> Debug for SharedContainer<T>

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

Formats the value using the given formatter.

impl<T: Debug + PartialEq> PartialEq for SharedContainer<T>

fn eq(&self, other: &Self) -> 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<T: Debug + Send> Send for SharedContainer<T>

impl<T: Debug + Send + Sync> Sync for SharedContainer<T>