Struct valence::ecs::world::VacantEntry

pub struct VacantEntry<'w, 'a, T>
where
    T: Component,
{ /* private fields */ }

A view into a vacant entry in a EntityWorldMut. It is part of the Entry enum.

Implementations

impl<'w, 'a, T> VacantEntry<'w, 'a, T>

where T: Component,

pub fn insert(self, component: T) -> Mut<'a, T>

Inserts the component into the VacantEntry and returns a mutable reference to it.

Examples

#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);

let mut entity = world.spawn_empty();

if let Entry::Vacant(v) = entity.entry::<Comp>() {
    v.insert(Comp(10));
}

assert_eq!(world.query::<&Comp>().single(&world).0, 10);

pub fn insert_entry(self, component: T) -> OccupiedEntry<'w, 'a, T>

Inserts the component into the VacantEntry and returns an OccupiedEntry.

Examples

#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);

let mut entity = world.spawn_empty();

if let Entry::Vacant(v) = entity.entry::<Comp>() {
    v.insert_entry(Comp(10));
}

assert_eq!(world.query::<&Comp>().single(&world).0, 10);