Flecs v4.1
A fast entity component system (ECS) for C & C++
Loading...
Searching...
No Matches
impl.hpp
Go to the documentation of this file.
1
6#pragma once
7
8#include "builder.hpp"
9
10namespace flecs
11{
12
17struct query_base {
20
23 : query_(q) {
24 flecs_poly_claim(q);
25 }
26
29 : query_(ECS_CONST_CAST(query_t*, q)) {
30 flecs_poly_claim(q);
31 }
32
35 if (desc->entity && desc->terms[0].id == 0) {
36 const flecs::Poly *query_poly = ecs_get_pair(
37 world, desc->entity, EcsPoly, EcsQuery);
38 if (query_poly) {
39 query_ = static_cast<flecs::query_t*>(query_poly->poly);
40 flecs_poly_claim(query_);
41 return;
42 }
43 }
44
45 query_ = ecs_query_init(world, desc);
46 }
47
49 query_base(const query_base& obj) {
50 this->query_ = obj.query_;
51 if (this->query_)
52 {
53 flecs_poly_claim(this->query_);
54 }
55 }
56
59 this->~query_base();
60 this->query_ = obj.query_;
61 if (this->query_)
62 {
63 flecs_poly_claim(this->query_);
64 }
65 return *this;
66 }
67
69 query_base(query_base&& obj) noexcept {
70 this->query_ = obj.query_;
71 obj.query_ = nullptr;
72 }
73
75 query_base& operator=(query_base&& obj) noexcept {
76 this->query_ = obj.query_;
77 obj.query_ = nullptr;
78 return *this;
79 }
80
83 return flecs::entity(query_->world, query_->entity);
84 }
85
87 const flecs::query_t* c_ptr() const {
88 return query_;
89 }
90
92 operator const flecs::query_t*() const {
93 return query_;
94 }
95
97 operator bool() const {
98 return query_ != nullptr;
99 }
100
106 void destruct() {
107 ecs_assert(query_->entity != 0, ECS_INVALID_OPERATION, "destruct() "
108 "should only be called on queries associated with entities");
109 ecs_query_fini(query_);
110 query_ = nullptr;
111 }
112
115 if (query_ && !query_->entity) {
116 if (!flecs_poly_release(query_)) {
117 ecs_query_fini(query_);
118 query_ = nullptr;
119 }
120 }
121 }
122
132 bool changed() const {
133 return ecs_query_changed(query_);
134 }
135
141 const flecs::query_group_info_t* group_info(uint64_t group_id) const {
142 return ecs_query_get_group_info(query_, group_id);
143 }
144
154
160 void* group_ctx(uint64_t group_id) const {
161 const flecs::query_group_info_t *gi = group_info(group_id);
162 if (gi) {
163 return gi->ctx;
164 } else {
165 return NULL;
166 }
167 }
168
170 template <typename Func>
171 void each_term(const Func& func) {
172 for (int i = 0; i < query_->term_count; i ++) {
173 flecs::term t(query_->world, query_->terms[i]);
174 func(t);
175 t.reset(); // prevent freeing resources
176 }
177 }
178
180 flecs::term term(int32_t index) const {
181 return flecs::term(query_->world, query_->terms[index]);
182 }
183
185 int32_t term_count() const {
186 return query_->term_count;
187 }
188
190 int32_t field_count() const {
191 return query_->field_count;
192 }
193
195 int32_t find_var(const char *name) const {
196 return ecs_query_find_var(query_, name);
197 }
198
199 bool has(flecs::entity_t e) const {
200 ecs_iter_t it;
201 bool result = ecs_query_has(query_, e, &it);
202 if (result) {
203 ecs_iter_fini(&it);
204 }
205 return result;
206 }
207
208 bool has(const flecs::table& t) const {
209 ecs_iter_t it;
210 bool result = ecs_query_has_table(query_, t.get_table(), &it);
211 if (result) {
212 ecs_iter_fini(&it);
213 }
214 return result;
215 }
216
217 bool has(const flecs::table_range& range) const {
218 ecs_table_range_t r = {
219 range.get_table(),
220 range.offset(),
221 range.count()
222 };
223 ecs_iter_t it;
224 bool result = ecs_query_has_range(query_, &r, &it);
225 if (result) {
226 ecs_iter_fini(&it);
227 }
228 return result;
229 }
230
233 char *result = ecs_query_str(query_);
234 return flecs::string(result);
235 }
236
242 char *result = ecs_query_plan(query_);
243 return flecs::string(result);
244 }
245
247 operator query<>() const;
248
249# ifdef FLECS_JSON
250# include "../json/query.inl"
251# endif
252
253protected:
254 query_t *query_ = nullptr;
255};
256
261template<typename ... Components>
262struct query : query_base, iterable<Components...> {
263private:
264 using Fields = typename _::field_ptrs<Components...>::array;
265
266public:
268
270 query() : query_base() { } // necessary not to confuse MSVC
271
273 query(const query& obj) : query_base(obj) { }
274
276 query& operator=(const query& obj) {
278 return *this;
279 }
280
282 query(query&& obj) noexcept : query_base(FLECS_MOV(obj)) { }
283
285 query& operator=(query&& obj) noexcept {
286 query_base::operator=(FLECS_FWD(obj));
287 return *this;
288 }
289
292 const flecs::query_t *q = ecs_query_get_cache_query(query_);
293 return flecs::query<>(q);
294 }
295
296private:
297 ecs_iter_t get_iter(flecs::world_t *world) const override {
298 ecs_assert(query_ != nullptr, ECS_INVALID_PARAMETER,
299 "cannot iterate invalid query");
300 if (!world) {
301 world = query_->world;
302 }
303 return ecs_query_iter(world, query_);
304 }
305
306 ecs_iter_next_action_t next_action() const override {
307 return ecs_query_next;
308 }
309};
310
311// World mixin implementation
312template <typename... Comps, typename... Args>
313inline flecs::query<Comps...> world::query(Args &&... args) const {
314 return flecs::query_builder<Comps...>(world_, FLECS_FWD(args)...)
315 .build();
316}
317
318inline flecs::query<> world::query(flecs::entity query_entity) const {
319 ecs_query_desc_t desc = {};
320 desc.entity = query_entity;
321 return flecs::query<>(world_, &desc);
322}
323
324template <typename... Comps, typename... Args>
325inline flecs::query_builder<Comps...> world::query_builder(Args &&... args) const {
326 return flecs::query_builder<Comps...>(world_, FLECS_FWD(args)...);
327}
328
329// world::each
330namespace _ {
331
332// Each with entity parameter
333template<typename Func, typename ... Args>
335
336template<typename Func, typename E>
337struct query_delegate_w_ent<Func, arg_list<E> >
338{
339 query_delegate_w_ent(const flecs::world& world, Func&& func) {
341
342 for (int32_t i = 0; i < entities.alive_count; i ++) {
343 func(flecs::entity(world, entities.ids[i]));
344 }
345 }
346};
347
348template<typename Func, typename E, typename ... Args>
349struct query_delegate_w_ent<Func, arg_list<E, Args ...> >
350{
351 query_delegate_w_ent(const flecs::world& world, Func&& func) {
352 auto f = world.query<Args ...>();
353 f.each(FLECS_MOV(func));
354 }
355};
356
357// Each without entity parameter
358template<typename Func, typename ... Args>
360
361template<typename Func, typename ... Args>
362struct query_delegate_no_ent<Func, arg_list<Args ...> >
363{
364 query_delegate_no_ent(const flecs::world& world, Func&& func) {
365 auto f = world.query<Args ...>();
366 f.each(FLECS_MOV(func));
367 }
368};
369
370// Switch between function with and without entity parameter
371template<typename Func, typename T = int>
373
374template <typename Func>
375struct query_delegate<Func, if_t<is_same<first_arg_t<Func>, flecs::entity>::value> > {
376 query_delegate(const flecs::world& world, Func&& func) {
378 }
379};
380
381template <typename Func>
382struct query_delegate<Func, if_not_t<is_same<first_arg_t<Func>, flecs::entity>::value> > {
383 query_delegate(const flecs::world& world, Func&& func) {
385 }
386};
387
388}
389
390template <typename Func>
391inline void world::each(Func&& func) const {
392 _::query_delegate<Func> f_delegate(*this, FLECS_MOV(func));
393}
394
395template <typename T, typename Func>
396inline void world::each(Func&& func) const {
397 ecs_iter_t it = ecs_each_id(world_, _::type<T>::id(world_));
398
399 while (ecs_each_next(&it)) {
400 _::each_delegate<Func, T>(func).invoke(&it);
401 }
402}
403
404template <typename Func>
405inline void world::each(flecs::id_t each_id, Func&& func) const {
406 ecs_iter_t it = ecs_each_id(world_, each_id);
407
408 while (ecs_each_next(&it)) {
409 _::each_delegate<Func>(func).invoke(&it);
410 }
411}
412
413// query_base implementation
414inline query_base::operator flecs::query<> () const {
415 return flecs::query<>(query_);
416}
417
418}
typename first_arg< Func >::type first_arg_t
Convenience alias for the first argument type of a callable.
const ecs_entity_t EcsQuery
Tag added to queries.
#define ecs_assert(condition, error_code,...)
Assert.
Definition log.h:473
#define ECS_INVALID_OPERATION
Invalid operation error code.
Definition log.h:669
#define ECS_INVALID_PARAMETER
Invalid parameter error code.
Definition log.h:671
flecs::query_builder< Comps... > query_builder(Args &&... args) const
Create a query builder.
void each(Func &&func) const
Iterate over all entities with components in the argument list of the function.
flecs::query< Comps... > query(Args &&... args) const
Create a query.
ecs_id_t id_t
ID type.
Definition c_types.hpp:20
ecs_entity_t entity_t
Entity type.
Definition c_types.hpp:21
ecs_world_t world_t
World type.
Definition c_types.hpp:18
ecs_iter_t ecs_each_id(const ecs_world_t *world, ecs_id_t component)
Iterate all entities with a specified (component ID).
bool ecs_each_next(ecs_iter_t *it)
Progress an iterator created with ecs_each_id().
#define ecs_get_pair(world, subject, First, second)
Get the first element of a pair.
Definition flecs_c.h:390
bool(* ecs_iter_next_action_t)(ecs_iter_t *it)
Function prototype for iterating an iterator.
Definition flecs.h:591
void ecs_iter_fini(ecs_iter_t *it)
Clean up iterator resources.
bool ecs_query_has_table(const ecs_query_t *query, ecs_table_t *table, ecs_iter_t *it)
Match a table with a query.
bool ecs_query_next(ecs_iter_t *it)
Progress a query iterator.
const ecs_query_group_info_t * ecs_query_get_group_info(const ecs_query_t *query, uint64_t group_id)
Get information about a query group.
bool ecs_query_has_range(const ecs_query_t *query, ecs_table_range_t *range, ecs_iter_t *it)
Match a range with a query.
int32_t ecs_query_find_var(const ecs_query_t *query, const char *name)
Find a variable index.
void ecs_query_fini(ecs_query_t *query)
Delete a query.
bool ecs_query_has(const ecs_query_t *query, ecs_entity_t entity, ecs_iter_t *it)
Match an entity with a query.
char * ecs_query_plan(const ecs_query_t *query)
Convert a query to a string.
ecs_iter_t ecs_query_iter(const ecs_world_t *world, const ecs_query_t *query)
Create a query iterator.
char * ecs_query_str(const ecs_query_t *query)
Convert a query to a string expression.
ecs_query_t * ecs_query_init(ecs_world_t *world, const ecs_query_desc_t *desc)
Create a query.
bool ecs_query_changed(ecs_query_t *query)
Return whether the query data changed since the last iteration.
const ecs_map_t * ecs_query_get_groups(const ecs_query_t *query)
Return the map with query groups.
const ecs_query_t * ecs_query_get_cache_query(const ecs_query_t *query)
Get the query used to populate the cache.
ecs_entities_t ecs_get_entities(const ecs_world_t *world)
Return entity identifiers in the world.
const ecs_world_t * ecs_get_world(const ecs_poly_t *poly)
Get the world from a poly.
Query builder.
JSON query mixin.
Component for storing a poly object.
Definition flecs.h:1606
ecs_poly_t * poly
Pointer to poly object.
Definition flecs.h:1607
Type returned by ecs_get_entities().
Definition flecs.h:2118
int32_t alive_count
Number of alive entity IDs.
Definition flecs.h:2121
const ecs_entity_t * ids
Array with all entity IDs in the world.
Definition flecs.h:2119
Iterator.
Definition flecs.h:1170
Used with ecs_query_init().
Definition flecs.h:1301
ecs_term_t terms[32]
Query terms.
Definition flecs.h:1306
ecs_entity_t entity
Entity associated with query (optional).
Definition flecs.h:1368
Type that contains information about a query group.
Definition flecs.h:1564
void * ctx
Group context, returned by on_group_create.
Definition flecs.h:1568
Queries are lists of constraints (terms) that match entities.
Definition flecs.h:838
ecs_world_t * world
World or stage the query was created with.
Definition flecs.h:871
ecs_entity_t entity
Entity associated with query (optional).
Definition flecs.h:869
ecs_term_t * terms
Query terms.
Definition flecs.h:841
int8_t term_count
Number of query terms.
Definition flecs.h:848
int8_t field_count
Number of fields returned by the query.
Definition flecs.h:849
ecs_id_t id
Component ID to be matched by term.
Definition flecs.h:815
Entity.
Definition entity.hpp:30
Base class for iterable query objects.
Definition iterable.hpp:22
Base class for queries.
Definition impl.hpp:17
const flecs::query_t * c_ptr() const
Get a pointer to the underlying C query.
Definition impl.hpp:87
bool changed() const
Return whether the query data changed since the last iteration.
Definition impl.hpp:132
query_base & operator=(const query_base &obj)
Copy assignment operator.
Definition impl.hpp:58
flecs::entity entity() const
Get the entity associated with the query.
Definition impl.hpp:82
void each_term(const Func &func)
Iterate each term in the query, invoking a callback for each.
Definition impl.hpp:171
query_base(query_base &&obj) noexcept
Move constructor.
Definition impl.hpp:69
query_base()
Default constructor.
Definition impl.hpp:19
flecs::map< uint64_t, void * > groups() const
Iterate the active groups of a grouped query.
Definition impl.hpp:151
void * group_ctx(uint64_t group_id) const
Get context for a group.
Definition impl.hpp:160
query_base(const query_t *q)
Construct from a const query pointer.
Definition impl.hpp:28
flecs::string plan() const
Return a string representing the query plan.
Definition impl.hpp:241
flecs::term term(int32_t index) const
Get term at the specified index.
Definition impl.hpp:180
query_base(query_t *q)
Construct from a mutable query pointer.
Definition impl.hpp:22
query_base(world_t *world, const ecs_query_desc_t *desc)
Construct from a world and a query descriptor.
Definition impl.hpp:34
query_base & operator=(query_base &&obj) noexcept
Move assignment operator.
Definition impl.hpp:75
query_base(const query_base &obj)
Copy constructor.
Definition impl.hpp:49
~query_base()
Destructor.
Definition impl.hpp:114
int32_t term_count() const
Get the number of terms in the query.
Definition impl.hpp:185
const flecs::query_group_info_t * group_info(uint64_t group_id) const
Get info for a group.
Definition impl.hpp:141
flecs::string str() const
Convert the query to a string expression.
Definition impl.hpp:232
void destruct()
Free a persistent query.
Definition impl.hpp:106
int32_t find_var(const char *name) const
Find a variable by name.
Definition impl.hpp:195
int32_t field_count() const
Get the number of fields in the query.
Definition impl.hpp:190
Query builder.
Definition builder.hpp:24
Typed query.
Definition impl.hpp:262
query_base()
Default constructor.
Definition impl.hpp:19
query()
Default constructor.
Definition impl.hpp:270
query(const query &obj)
Copy constructor.
Definition impl.hpp:273
flecs::query cache_query() const
Get the cache query, if any.
Definition impl.hpp:291
query & operator=(query &&obj) noexcept
Move assignment operator.
Definition impl.hpp:285
query & operator=(const query &obj)
Copy assignment operator.
Definition impl.hpp:276
query(query &&obj) noexcept
Move constructor.
Definition impl.hpp:282
Owned string wrapper.
Definition string.hpp:15
Table range.
Definition table.hpp:449
int32_t count() const
Get the number of entities in the range.
Definition table.hpp:474
int32_t offset() const
Get the offset of the range.
Definition table.hpp:469
Table.
Definition table.hpp:23
table_t * get_table() const
Get the table.
Definition table.hpp:430
Class that describes a term.
Definition impl.hpp:16
void reset()
Reset the term to its default state.
Definition impl.hpp:82
The world.
Definition world.hpp:246
world_t * world_
Pointer to the underlying C world.
Definition world.hpp:1540
enable_if_t< false==V, int > if_not_t
Convenience enable_if alias for negated conditions.
Definition utils.hpp:172
enable_if_t< V, int > if_t
Convenience enable_if alias using int as default type.
Definition utils.hpp:168