Struct bevy::ecs::world::EntityMut

pub struct EntityMut<'w> { /* private fields */ }

A mutable reference to a particular Entity and all of its components

Implementations

impl<'w> EntityMut<'w>

pub fn id(&self) -> Entity

pub fn location(&self) -> EntityLocation

pub fn archetype(&self) -> &Archetype

pub fn contains<T>(&self) -> boolwhere T: Component,

pub fn contains_id(&self, component_id: ComponentId) -> bool

pub fn contains_type_id(&self, type_id: TypeId) -> bool

pub fn get<T>(&self) -> Option<&T>where T: Component,

pub fn get_mut<T>(&mut self) -> Option<Mut<'_, T>>where T: Component,

pub fn get_change_ticks<T>(&self) -> Option<ComponentTicks>where T: Component,

Retrieves the change ticks for the given component. This can be useful for implementing change detection in custom runtimes.

pub fn get_change_ticks_by_id( &self, component_id: ComponentId ) -> Option<ComponentTicks>

Retrieves the change ticks for the given ComponentId. This can be useful for implementing change detection in custom runtimes.

You should prefer to use the typed API EntityMut::get_change_ticks where possible and only use this in cases where the actual component types are not known at compile time.

pub fn insert<T>(&mut self, bundle: T) -> &mut EntityMut<'w>where T: Bundle,

Adds a Bundle of components to the entity.

This will overwrite any previous value(s) of the same component type.

pub fn take<T>(&mut self) -> Option<T>where T: Bundle,

Removes all components in the Bundle from the entity and returns their previous values.

Note: If the entity does not have every component in the bundle, this method will not remove any of them.

pub fn remove<T>(&mut self) -> &mut EntityMut<'w>where T: Bundle,

Removes any components in the Bundle from the entity.

pub fn despawn(self)

pub fn world(&self) -> &World

pub unsafe fn world_mut(&mut self) -> &mut World

Returns this EntityMut’s world.

See EntityMut::world_scope or EntityMut::into_world_mut for a safe alternative.

Safety

Caller must not modify the world in a way that changes the current entity’s location If the caller does do something that could change the location, self.update_location() must be called before using any other methods on this EntityMut.

pub fn into_world_mut(self) -> &'w mut World

Return this EntityMut’s World, consuming itself.

pub fn world_scope<U>(&mut self, f: impl FnOnce(&mut World) -> U) -> U

Gives mutable access to this EntityMut’s World in a temporary scope. This is a safe alternative to using Self::world_mut.

Examples

#[derive(Resource, Default, Clone, Copy)]
struct R(u32);

// This closure gives us temporary access to the world.
let new_r = entity.world_scope(|world: &mut World| {
    // Mutate the world while we have access to it.
    let mut r = world.resource_mut::<R>();
    r.0 += 1;
     
    // Return a value from the world before giving it back to the `EntityMut`.
    *r
});

pub fn update_location(&mut self)

Updates the internal entity location to match the current location in the internal World.

This is only required when using the unsafe function EntityMut::world_mut, which enables the location to change.

impl<'w> EntityMut<'w>

pub fn get_by_id(&self, component_id: ComponentId) -> Option<Ptr<'_, Aligned>>

Gets the component of the given ComponentId from the entity.

You should prefer to use the typed API EntityMut::get where possible and only use this in cases where the actual component types are not known at compile time.

Unlike EntityMut::get, this returns a raw pointer to the component, which is only valid while the EntityMut is alive.

pub fn get_mut_by_id( &mut self, component_id: ComponentId ) -> Option<MutUntyped<'_>>

Gets a MutUntyped of the component of the given ComponentId from the entity.

You should prefer to use the typed API EntityMut::get_mut where possible and only use this in cases where the actual component types are not known at compile time.

Unlike EntityMut::get_mut, this returns a raw pointer to the component, which is only valid while the EntityMut is alive.

Trait Implementations

impl<'w> BuildWorldChildren for EntityMut<'w>

fn with_children( &mut self, spawn_children: impl FnOnce(&mut WorldChildBuilder<'_>) ) -> &mut EntityMut<'w>

Creates a WorldChildBuilder with the given children built in the given closure

fn add_child(&mut self, child: Entity) -> &mut EntityMut<'w>

Adds a single child

fn push_children(&mut self, children: &[Entity]) -> &mut EntityMut<'w>

Pushes children to the back of the builder’s children

fn insert_children( &mut self, index: usize, children: &[Entity] ) -> &mut EntityMut<'w>

Inserts children at the given index

fn remove_children(&mut self, children: &[Entity]) -> &mut EntityMut<'w>

Removes the given children

fn set_parent(&mut self, parent: Entity) -> &mut EntityMut<'w>

Set the parent of this entity. This entity will be added to the end of the parent’s list of children.

fn remove_parent(&mut self) -> &mut EntityMut<'w>

Remove the parent from this entity.

impl<'w> DespawnRecursiveExt for EntityMut<'w>

fn despawn_recursive(self)

Despawns the provided entity and its children.

fn despawn_descendants(&mut self)

Despawns all descendants of the given entity.

impl<'w> From<EntityMut<'w>> for EntityRef<'w>

fn from(entity_mut: EntityMut<'w>) -> EntityRef<'w>

Converts to this type from the input type.