Struct CommandBuffer 

pub struct CommandBuffer { /* private fields */ }

Records operations for future application to a World

Useful when operations cannot be applied directly due to ordering concerns or borrow checking.

let mut world = World::new();
let entity = world.reserve_entity();
let mut cmd = CommandBuffer::new();
cmd.insert(entity, (true, 42));
cmd.run_on(&mut world); // cmd can now be reused
assert_eq!(*world.get::<&i32>(entity).unwrap(), 42);

Implementations

impl CommandBuffer

pub fn new() -> Self

Create an empty command buffer

pub fn insert(&mut self, entity: Entity, components: impl DynamicBundle)

Add components from bundle to entity, if it exists

Pairs well with World::reserve_entity to spawn entities with a known handle.

When inserting a single component, see insert_one for convenience.

pub fn insert_one(&mut self, entity: Entity, component: impl Component)

Add component to entity, if the entity exists

See insert.

pub fn remove<T: Bundle + 'static>(&mut self, ent: Entity)

Remove components from entity if they exist

When removing a single component, see remove_one for convenience.

pub fn remove_one<T: Component>(&mut self, ent: Entity)

Remove a component from entity if it exists

See remove.

pub fn despawn(&mut self, entity: Entity)

Despawn entity from World

pub fn spawn(&mut self, components: impl DynamicBundle)

Spawn a new entity with components

If the Entity is needed immediately, consider combining World::reserve_entity with insert instead.

pub fn run_on(&mut self, world: &mut World)

Run recorded commands on world, clearing the command buffer

pub fn clear(&mut self)

Drop all recorded commands

pub fn len(&mut self) -> usize

Number of commands

pub fn is_empty(&mut self) -> bool

check if there were any commands recorded

Trait Implementations

impl Default for CommandBuffer

fn default() -> Self

Create an empty buffer

impl Drop for CommandBuffer

fn drop(&mut self)

Executes the destructor for this type.

impl GetStaticEquivalent_ for CommandBuffer

type StaticEquivalent = _static_CommandBuffer

The 'static equivalent of Self

impl StableAbi for CommandBuffer

const LAYOUT: &'static TypeLayout

The layout of the type provided by implementors.

type IsNonZeroType = False

Whether this type has a single invalid bit-pattern.

const ABI_CONSTS: AbiConsts = _

const-equivalents of the associated types.

impl Send for CommandBuffer

impl Sync for CommandBuffer