Function ecs_query_populate

Synopsis

#include <include/flecs.h>

FLECS_API void ecs_query_populate(ecs_iter_t *iter)

Description

Populate iterator fields. This operation can be combined with ecs_query_next_table to populate the iterator fields for the current table.

Populating fields conditionally can save time when a query uses change detection, and only needs iterator data when the table has changed. When this operation is called, inout/out terms will be marked dirty.

In cases where inout/out terms are conditionally written and no changes were made after calling ecs_query_populate, the ecs_query_skip function can be called to prevent the matched table components from being marked dirty.

This operation does should not be used with queries that match disabled components, union relationships, or with queries that use order_by.

Parameters

iter - The iterator.

Source

Line 3535 in include/flecs.h.