Struct SharedWorld

pub struct SharedWorld(/* private fields */);

Helper type to share the world parameter passed to Dispatcher::dispatch.

Methods from Deref<Target = World>

pub fn resource<T: Resource>(&self) -> Ref<'_, T>

pub fn resource_mut<T: Resource>(&self) -> RefMut<'_, T>

pub fn resource_raw(&self, id: &ResourceId) -> Option<&Cell<Box<dyn Resource>>>

pub fn entities(&self) -> Read<'_, Entities>

pub fn entities_mut(&self) -> RefMut<'_, Entities>

pub fn lazy(&self) -> Read<'_, Lazy>

pub fn component<T: Component>(&self) -> ReadStorage<'_, T>

pub fn component_mut<T: Component>(&self) -> WriteStorage<'_, T>

pub fn is_alive(&self, entity: Entity) -> bool

Methods from Deref<Target = Resources>

pub fn entry<R>(&mut self) -> Entry<'_, R>

where R: Resource,

Returns an entry for the resource with type R.

pub fn insert<R>(&mut self, r: R)

where R: Resource,

Inserts a resource into this container. If the resource existed before, it will be overwritten.

Examples

Every type satisfying Any + Send + Sync automatically implements Resource, thus can be added:

struct MyRes(i32);

When you have a resource, simply insert it like this:

use async_ecs::World;

let mut world = World::default();
world.insert(MyRes(5));

pub fn remove<R>(&mut self) -> Option<R>

where R: Resource,

Removes a resource of type R from this container and returns its ownership to the caller. In case there is no such resource in this, container, None will be returned.

Use this method with caution; other functions and systems might assume this resource still exists. Thus, only use this if you’re sure no system will try to access this resource after you removed it (or else you will get a panic).

pub fn contains<R>(&self) -> bool

where R: Resource,

Returns true if the specified resource type R exists in self.

pub fn borrow<R>(&self) -> Ref<'_, R>

where R: Resource,

Fetches the resource with the specified type T or panics if it doesn’t exist.

Panics

Panics if the resource doesn’t exist. Panics if the resource is being accessed mutably.

pub fn try_borrow<R>(&self) -> Option<Ref<'_, R>>

where R: Resource,

Like fetch, but returns an Option instead of inserting a default value in case the resource does not exist.

pub fn borrow_mut<R>(&self) -> RefMut<'_, R>

where R: Resource,

Fetches the resource with the specified type T mutably.

Please see fetch for details.

Panics

Panics if the resource doesn’t exist. Panics if the resource is already being accessed.

pub fn try_borrow_mut<R>(&self) -> Option<RefMut<'_, R>>

where R: Resource,

Like fetch_mut, but returns an Option instead of inserting a default value in case the resource does not exist.

pub fn get_mut<R: Resource>(&mut self) -> Option<&mut R>

Retrieves a resource without fetching, which is cheaper, but only available with &mut self.

pub fn get_resource_mut(&mut self, id: ResourceId) -> Option<&mut dyn Resource>

Retrieves a resource without fetching, which is cheaper, but only available with &mut self.

pub fn get_raw(&self, id: &ResourceId) -> Option<&Cell<Box<dyn Resource>>>

Get raw access to the underlying cell.

Trait Implementations

impl Clone for SharedWorld

fn clone(&self) -> SharedWorld

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for SharedWorld

fn default() -> Self

Returns the “default value” for a type.

impl Deref for SharedWorld

type Target = World

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Send for SharedWorld

impl Sync for SharedWorld