pub struct ComponentsRegistrator<'w> { /* private fields */ }
Expand description
A Components
wrapper that enables additional features, like registration.
Implementations§
Source§impl<'w> ComponentsRegistrator<'w>
impl<'w> ComponentsRegistrator<'w>
Sourcepub unsafe fn new(
components: &'w mut Components,
ids: &'w mut ComponentIds,
) -> Self
pub unsafe fn new( components: &'w mut Components, ids: &'w mut ComponentIds, ) -> Self
Constructs a new ComponentsRegistrator
.
§Safety
The Components
and ComponentIds
must match.
For example, they must be from the same world.
Sourcepub fn as_queued(&self) -> ComponentsQueuedRegistrator<'_>
pub fn as_queued(&self) -> ComponentsQueuedRegistrator<'_>
Converts this ComponentsRegistrator
into a ComponentsQueuedRegistrator
.
This is intended for use to pass this value to a function that requires ComponentsQueuedRegistrator
.
It is generally not a good idea to queue a registration when you can instead register directly on this type.
Sourcepub fn apply_queued_registrations(&mut self)
pub fn apply_queued_registrations(&mut self)
Applies every queued registration.
This ensures that every valid ComponentId
is registered,
enabling retrieving ComponentInfo
, etc.
Sourcepub fn register_component<T: Component>(&mut self) -> ComponentId
pub fn register_component<T: Component>(&mut self) -> ComponentId
Sourcepub fn register_component_with_descriptor(
&mut self,
descriptor: ComponentDescriptor,
) -> ComponentId
pub fn register_component_with_descriptor( &mut self, descriptor: ComponentDescriptor, ) -> ComponentId
Registers a component described by descriptor
.
§Note
If this method is called multiple times with identical descriptors, a distinct ComponentId
will be created for each one.
§See also
Sourcepub fn register_resource<T: Resource>(&mut self) -> ComponentId
pub fn register_resource<T: Resource>(&mut self) -> ComponentId
Sourcepub fn register_non_send<T: Any>(&mut self) -> ComponentId
pub fn register_non_send<T: Any>(&mut self) -> ComponentId
Registers a non-send resource of type T
with this instance.
If a resource of this type has already been registered, this will return
the ID of the pre-existing resource.
Sourcepub fn register_resource_with_descriptor(
&mut self,
descriptor: ComponentDescriptor,
) -> ComponentId
pub fn register_resource_with_descriptor( &mut self, descriptor: ComponentDescriptor, ) -> ComponentId
Registers a Resource
described by descriptor
.
§Note
If this method is called multiple times with identical descriptors, a distinct ComponentId
will be created for each one.
§See also
Methods from Deref<Target = Components>§
Sourcepub fn len(&self) -> usize
pub fn len(&self) -> usize
Returns the number of components registered or queued with this instance.
Sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Returns true
if there are no components registered or queued with this instance. Otherwise, this returns false
.
Sourcepub fn num_queued(&self) -> usize
pub fn num_queued(&self) -> usize
Returns the number of components registered with this instance.
Sourcepub fn any_queued(&self) -> bool
pub fn any_queued(&self) -> bool
Returns true
if there are any components registered with this instance. Otherwise, this returns false
.
Sourcepub fn num_queued_mut(&mut self) -> usize
pub fn num_queued_mut(&mut self) -> usize
A faster version of Self::num_queued
.
Sourcepub fn any_queued_mut(&mut self) -> bool
pub fn any_queued_mut(&mut self) -> bool
A faster version of Self::any_queued
.
Sourcepub fn num_registered(&self) -> usize
pub fn num_registered(&self) -> usize
Returns the number of components registered with this instance.
Sourcepub fn any_registered(&self) -> bool
pub fn any_registered(&self) -> bool
Returns true
if there are any components registered with this instance. Otherwise, this returns false
.
Sourcepub fn get_info(&self, id: ComponentId) -> Option<&ComponentInfo>
pub fn get_info(&self, id: ComponentId) -> Option<&ComponentInfo>
Gets the metadata associated with the given component, if it is registered.
This will return None
if the id is not regiserted or is queued.
This will return an incorrect result if id
did not come from the same world as self
. It may return None
or a garbage value.
Sourcepub fn get_descriptor<'a>(
&'a self,
id: ComponentId,
) -> Option<Cow<'a, ComponentDescriptor>>
pub fn get_descriptor<'a>( &'a self, id: ComponentId, ) -> Option<Cow<'a, ComponentDescriptor>>
Gets the ComponentDescriptor
of the component with this ComponentId
if it is present.
This will return None
only if the id is neither regisered nor queued to be registered.
Currently, the Cow
will be Cow::Owned
if and only if the component is queued. It will be Cow::Borrowed
otherwise.
This will return an incorrect result if id
did not come from the same world as self
. It may return None
or a garbage value.
Sourcepub fn get_name<'a>(&'a self, id: ComponentId) -> Option<Cow<'a, str>>
pub fn get_name<'a>(&'a self, id: ComponentId) -> Option<Cow<'a, str>>
Gets the name of the component with this ComponentId
if it is present.
This will return None
only if the id is neither regisered nor queued to be registered.
This will return an incorrect result if id
did not come from the same world as self
. It may return None
or a garbage value.
Sourcepub unsafe fn get_info_unchecked(&self, id: ComponentId) -> &ComponentInfo
pub unsafe fn get_info_unchecked(&self, id: ComponentId) -> &ComponentInfo
Gets the metadata associated with the given component.
§Safety
id
must be a valid and fully registered ComponentId
.
Sourcepub fn is_id_valid(&self, id: ComponentId) -> bool
pub fn is_id_valid(&self, id: ComponentId) -> bool
Returns true if the ComponentId
is fully registered and valid.
Ids may be invalid if they are still queued to be registered.
Those ids are still correct, but they are not usable in every context yet.
Sourcepub fn get_valid_id(&self, type_id: TypeId) -> Option<ComponentId>
pub fn get_valid_id(&self, type_id: TypeId) -> Option<ComponentId>
Type-erased equivalent of Components::valid_component_id()
.
Sourcepub fn valid_component_id<T: Component>(&self) -> Option<ComponentId>
pub fn valid_component_id<T: Component>(&self) -> Option<ComponentId>
Returns the ComponentId
of the given Component
type T
if it is fully registered.
If you want to include queued registration, see Components::component_id()
.
use bevy_ecs::prelude::*;
let mut world = World::new();
#[derive(Component)]
struct ComponentA;
let component_a_id = world.register_component::<ComponentA>();
assert_eq!(component_a_id, world.components().valid_component_id::<ComponentA>().unwrap())
§See also
Sourcepub fn get_valid_resource_id(&self, type_id: TypeId) -> Option<ComponentId>
pub fn get_valid_resource_id(&self, type_id: TypeId) -> Option<ComponentId>
Type-erased equivalent of Components::valid_resource_id()
.
Sourcepub fn valid_resource_id<T: Resource>(&self) -> Option<ComponentId>
pub fn valid_resource_id<T: Resource>(&self) -> Option<ComponentId>
Returns the ComponentId
of the given Resource
type T
if it is fully registered.
If you want to include queued registration, see Components::resource_id()
.
use bevy_ecs::prelude::*;
let mut world = World::new();
#[derive(Resource, Default)]
struct ResourceA;
let resource_a_id = world.init_resource::<ResourceA>();
assert_eq!(resource_a_id, world.components().valid_resource_id::<ResourceA>().unwrap())
§See also
Sourcepub fn get_id(&self, type_id: TypeId) -> Option<ComponentId>
pub fn get_id(&self, type_id: TypeId) -> Option<ComponentId>
Type-erased equivalent of Components::component_id()
.
Sourcepub fn component_id<T: Component>(&self) -> Option<ComponentId>
pub fn component_id<T: Component>(&self) -> Option<ComponentId>
Returns the ComponentId
of the given Component
type T
.
The returned ComponentId
is specific to the Components
instance
it was retrieved from and should not be used with another Components
instance.
Returns None
if the Component
type has not
yet been initialized using ComponentsRegistrator::register_component()
or ComponentsQueuedRegistrator::queue_register_component()
.
use bevy_ecs::prelude::*;
let mut world = World::new();
#[derive(Component)]
struct ComponentA;
let component_a_id = world.register_component::<ComponentA>();
assert_eq!(component_a_id, world.components().component_id::<ComponentA>().unwrap())
§See also
Sourcepub fn get_resource_id(&self, type_id: TypeId) -> Option<ComponentId>
pub fn get_resource_id(&self, type_id: TypeId) -> Option<ComponentId>
Type-erased equivalent of Components::resource_id()
.
Sourcepub fn resource_id<T: Resource>(&self) -> Option<ComponentId>
pub fn resource_id<T: Resource>(&self) -> Option<ComponentId>
Returns the ComponentId
of the given Resource
type T
.
The returned ComponentId
is specific to the Components
instance
it was retrieved from and should not be used with another Components
instance.
Returns None
if the Resource
type has not
yet been initialized using ComponentsRegistrator::register_resource()
or ComponentsQueuedRegistrator::queue_register_resource()
.
use bevy_ecs::prelude::*;
let mut world = World::new();
#[derive(Resource, Default)]
struct ResourceA;
let resource_a_id = world.init_resource::<ResourceA>();
assert_eq!(resource_a_id, world.components().resource_id::<ResourceA>().unwrap())
§See also
Sourcepub fn iter_registered(&self) -> impl Iterator<Item = &ComponentInfo> + '_
pub fn iter_registered(&self) -> impl Iterator<Item = &ComponentInfo> + '_
Gets an iterator over all components fully registered with this instance.
Trait Implementations§
Source§impl Deref for ComponentsRegistrator<'_>
impl Deref for ComponentsRegistrator<'_>
Auto Trait Implementations§
impl<'w> Freeze for ComponentsRegistrator<'w>
impl<'w> !RefUnwindSafe for ComponentsRegistrator<'w>
impl<'w> !Send for ComponentsRegistrator<'w>
impl<'w> !Sync for ComponentsRegistrator<'w>
impl<'w> Unpin for ComponentsRegistrator<'w>
impl<'w> !UnwindSafe for ComponentsRegistrator<'w>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
, which can then be
downcast
into Box<dyn ConcreteType>
where ConcreteType
implements Trait
.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
, which can then be further
downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.