Struct hecs::EntityBuilder
source · pub struct EntityBuilder { /* private fields */ }
Expand description
Helper for incrementally constructing a bundle of components with dynamic component types
Prefer reusing the same builder over creating new ones repeatedly.
let mut world = World::new();
let mut builder = EntityBuilder::new();
builder.add(123).add("abc");
let e = world.spawn(builder.build()); // builder can now be reused
assert_eq!(*world.get::<&i32>(e).unwrap(), 123);
assert_eq!(*world.get::<&&str>(e).unwrap(), "abc");
Implementations§
source§impl EntityBuilder
impl EntityBuilder
sourcepub fn add<T: Component>(&mut self, component: T) -> &mut Self
pub fn add<T: Component>(&mut self, component: T) -> &mut Self
Add component
to the entity.
If the bundle already contains a component of type T
, it will
be dropped and replaced with the most recently added one.
sourcepub fn add_bundle(&mut self, bundle: impl DynamicBundle) -> &mut Self
pub fn add_bundle(&mut self, bundle: impl DynamicBundle) -> &mut Self
Add all components in bundle
to the entity.
If the bundle contains any component which matches the type of a component
already in the EntityBuilder
, the newly added component from the bundle
will replace the old component and the old component will be dropped.
sourcepub fn build(&mut self) -> BuiltEntity<'_>
pub fn build(&mut self) -> BuiltEntity<'_>
Construct a Bundle
suitable for spawning
sourcepub fn get<'a, T: ComponentRefShared<'a>>(&'a self) -> Option<T>
pub fn get<'a, T: ComponentRefShared<'a>>(&'a self) -> Option<T>
Borrow a shared reference T
to some component type, if it exists
Takes a reference as its type parameter for consistency with
EntityRef::get
, even though it cannot be a unique reference
because EntityBuilder
does not perform dynamic borrow checking.
sourcepub fn get_mut<'a, T: ComponentRef<'a>>(&'a mut self) -> Option<T>
pub fn get_mut<'a, T: ComponentRef<'a>>(&'a mut self) -> Option<T>
Borrow a shared or unique reference T
to some component type, if it exists
sourcepub fn component_types(&self) -> impl Iterator<Item = TypeId> + '_
pub fn component_types(&self) -> impl Iterator<Item = TypeId> + '_
Enumerate the types of the entity builder’s components