Skip to content

Queries

As a key concept behind fennecs, Queries have three main purposes.

Each Query is a view into a World, representing a subset of its Entities. Queries are incredibly fast and update accordingly whenever entities spawn or their component structure changes.

(expand to see world)

A World contains Entities and their Components, as well as their structure and Relations. World Example: blue circle labeled world filled with fox emojis with many different traits

Query Visualization: fox emojis with various traits grouped by common traits in several colored boxes

1. Matching & Filtering Entities

It remains associated with this specific World, and Queries can not bridge multiple Worlds. Queries use Match Expressions to define the subset of Entities they contain ("match").

2. Processing Data (via Stream Queries)

The most powerful feature of Queries is that they can un code on all Entities they match; and even feed references to component data (the Stream Types) to the delegate code being passed in.

3. Bulk Create, Read, Update, Delete

Queries expose methods to operate quickly and with clear intent on all the entities matched by the query - read more!

Use the method Query.Despawn() to despawn all Entities in that Query. Alternatively, use Query.Truncate(int, TruncateMode) to cut your Query down to a specific size.

fennecs is released under the MIT License. Neofox is released under the CC BY-NC-SA 4.0 License.