Struct app_world::AppWorldWrapper

pub struct AppWorldWrapper<W: AppWorld> { /* private fields */ }

Holds application state and resources. See the crate level documentation for more details.

Cloning

Cloning an AppWorldWrapper is a very cheap operation.

All clones hold pointers to the same inner state.

Implementations

impl<W: AppWorld + 'static> AppWorldWrapper<W>

pub fn new(world: W) -> Self

Create a new AppWorldWrapper.

pub fn msg(&self, msg: W::Message)

Acquire write access to the AppWorld then send a message.

impl<W: AppWorld + 'static> AppWorldWrapper<W>

pub fn read(&self) -> WorldReadGuard<'_, W>

Acquire read access to AppWorld.

Panics

Panics if the current thread is already holding a read guard.

This panic prevents the following scenario from deadlocking:

1. Thread A acquires a read guard
2. Thread B calls AppWorld::msg, which attempts to acquire a write lock
3. Thread A attempts to acquire a second read guard while the first is still active

Trait Implementations

impl<W: AppWorld> Clone for AppWorldWrapper<W>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.