Struct bevy_hecs::EntityBuilder

pub struct EntityBuilder { /* fields omitted */ }

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

impl EntityBuilder

pub fn new() -> Self

Create a builder representing an entity with no components

pub fn add<T: Component>(&mut self, component: T) -> &mut Self

Add component to the entity

pub fn build(&mut self) -> BuiltEntity<'_>

Construct a Bundle suitable for spawning

pub fn clear(&mut self)

Drop previously added components

The builder is cleared implicitly when an entity is built, so this doesn't usually need to be called.

Trait Implementations

impl Default for EntityBuilder

fn default() -> Self

Returns the "default value" for a type.

impl Drop for EntityBuilder

fn drop(&mut self)

Executes the destructor for this type.

impl Send for EntityBuilder

impl Sync for EntityBuilder