Skip to content

EntityQuery.Execute() Method

Definition

Namespace: Brine2D.ECS.Query

Executes the query and returns matching entities.

C#
public System.Collections.Generic.IEnumerable<Brine2D.ECS.Entity> Execute();

Returns

System.Collections.Generic.IEnumerable<Entity>

Remarks

The pool-based path rents an System.Buffers.ArrayPool<> buffer that is returned when the enumerator is disposed. Standard foreach and LINQ methods handle this automatically. Avoid calling GetEnumerator() without ensuring disposal.

This query re-evaluates filters on every call. For per-frame iteration in systems, prefer CachedEntityQuery<T1> (via CreateCachedQuery<T1>()), which rebuilds only when structural changes invalidate the cache.