Trait bevy_ecs::world::Command

source ·
pub trait Command: Send + 'static {
    // Required method
    fn apply(self, world: &mut World);
}
Expand description

A World mutation.

Should be used with Commands::add.

§Usage

// Our world resource
#[derive(Resource, Default)]
struct Counter(u64);

// Our custom command
struct AddToCounter(u64);

impl Command for AddToCounter {
    fn apply(self, world: &mut World) {
        let mut counter = world.get_resource_or_insert_with(Counter::default);
        counter.0 += self.0;
    }
}

fn some_system(mut commands: Commands) {
    commands.add(AddToCounter(42));
}

Required Methods§

source

fn apply(self, world: &mut World)

Applies this command, causing it to mutate the provided world.

This method is used to define what a command “does” when it is ultimately applied. Because this method takes self, you can store data or settings on the type that implements this trait. This data is set by the system or other source of the command, and then ultimately read in this method.

Implementors§

source§

impl<E: Event, Targets: TriggerTargets> Command for EmitDynamicTrigger<E, Targets>

source§

impl<E: Event, Targets: TriggerTargets> Command for TriggerEvent<E, Targets>

source§

impl<F> Command for F
where F: FnOnce(&mut World) + Send + 'static,

source§

impl<I: 'static + Send> Command for RunSystemWithInput<I>

source§

impl<I: 'static + Send, O: 'static + Send> Command for RegisterSystem<I, O>

source§

impl<M, C: EntityCommand<M>> Command for WithEntity<M, C>
where M: 'static,