Struct EntityEntryCommands

pub struct EntityEntryCommands<'a, T> { /* private fields */ }

A wrapper around EntityCommands with convenience methods for working with a specified component type.

Implementations

impl<'a, T: Component> EntityEntryCommands<'a, T>

pub fn and_modify( &mut self, modify: impl FnOnce(Mut<'_, T>) + Send + Sync + 'static, ) -> &mut Self

Modify the component T if it exists, using the function modify.

pub fn or_insert(&mut self, default: T) -> &mut Self

Insert default into this entity, if T is not already present.

See also or_insert_with.

Panics

Panics if the entity does not exist. See or_try_insert for a non-panicking version.

pub fn or_try_insert(&mut self, default: T) -> &mut Self

Insert default into this entity, if T is not already present.

Unlike or_insert, this will not panic if the entity does not exist.

See also or_insert_with.

pub fn or_insert_with(&mut self, default: impl Fn() -> T) -> &mut Self

Insert the value returned from default into this entity, if T is not already present.

See also or_insert and or_try_insert.

Panics

Panics if the entity does not exist. See or_try_insert_with for a non-panicking version.

pub fn or_try_insert_with(&mut self, default: impl Fn() -> T) -> &mut Self

Insert the value returned from default into this entity, if T is not already present.

Unlike or_insert_with, this will not panic if the entity does not exist.

See also or_insert and or_try_insert.

pub fn or_default(&mut self) -> &mut Self

where T: Default,

Insert T::default into this entity, if T is not already present.

See also or_insert and or_from_world.

Panics

Panics if the entity does not exist.

pub fn or_from_world(&mut self) -> &mut Self

where T: FromWorld,

Insert T::from_world into this entity, if T is not already present.

See also or_insert and or_default.

Panics

Panics if the entity does not exist.