Struct rs_ecs::World

pub struct World { /* fields omitted */ }

The ECS world storing Entity and components.

Implementations

impl World

pub fn new() -> Self

Create an empty world.

impl World

#[must_use]

pub fn alloc(&mut self) -> Entity

Create an Entity without any components. To add components, see Self::insert().

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));

pub fn free(&mut self, ent: Entity)

Remove an Entity and all its components from the world. To remove components, see Self::remove().

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));

world.free(entity);

impl World

pub fn insert<B>(&mut self, ent: Entity, comps: B) where
    B: Bundle, 

Insert components for a given Entity.

Panics

Panics if one of the components is already present for the entity.

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));
world.insert(entity, (String::from("Hello"),));

pub fn remove<B>(&mut self, ent: Entity) -> Option<B> where
    B: Bundle, 

Remove components for a given Entity.

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true, String::from("Hello")));

world.remove::<(u32, bool)>(entity).unwrap();
world.remove::<(String,)>(entity).unwrap();

impl World

pub fn contains<C>(&self, ent: Entity) -> bool where
    C: 'static, 

Check if a certain component type is present for an Entity.

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));

assert!(world.contains::<u32>(entity));

pub fn get<C>(&self, ent: Entity) -> Option<Comp<'_, C>> where
    C: 'static, 

Get an immutable reference to the component of the given type for an Entity.

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));

let comp = world.get::<u32>(entity).unwrap();

pub fn get_mut<C>(&self, ent: Entity) -> Option<CompMut<'_, C>> where
    C: 'static, 

Get a mutable reference to the component of the given type for an Entity.

Example

let mut world = World::new();

let entity = world.alloc();
world.insert(entity, (42_u32, true));

let comp = world.get_mut::<u32>(entity).unwrap();

Trait Implementations

impl Default for World

fn default() -> Self

Create an empty world.