Struct QueryBuilder

Namespace

KeenEyes

Assembly

KeenEyes.Core.dll

Fluent builder for constructing queries.

public readonly struct QueryBuilder : IQueryBuilder, IEnumerable<Entity>, IEnumerable

Implements

IQueryBuilder

IEnumerable<Entity>

IEnumerable

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Extension Methods

ParallelQueryExtensions.ForEachParallelReadOnly<T1>(QueryBuilder, EntityActionReadOnly<T1>, int)

ParallelQueryExtensions.ForEachParallelReadOnly<T1, T2>(QueryBuilder, EntityActionReadOnly<T1, T2>, int)

ParallelQueryExtensions.ForEachParallelReadOnly<T1, T2, T3>(QueryBuilder, EntityActionReadOnly<T1, T2, T3>, int)

ParallelQueryExtensions.ForEachParallelReadOnly<T1, T2, T3, T4>(QueryBuilder, EntityActionReadOnly<T1, T2, T3, T4>, int)

ParallelQueryExtensions.ForEachParallel<T1>(QueryBuilder, EntityAction<T1>, int)

ParallelQueryExtensions.ForEachParallel<T1, T2>(QueryBuilder, EntityAction<T1, T2>, int)

ParallelQueryExtensions.ForEachParallel<T1, T2, T3>(QueryBuilder, EntityAction<T1, T2, T3>, int)

ParallelQueryExtensions.ForEachParallel<T1, T2, T3, T4>(QueryBuilder, EntityAction<T1, T2, T3, T4>, int)

Properties

Description

Gets the query description.

public QueryDescription Description { get; }

Property Value

QueryDescription

World

Gets the world this query operates on.

public World World { get; }

Property Value

World

Methods

Count()

Counts the number of entities matching this query.

public int Count()

Returns

int

The number of entities matching the query.

Remarks

This method is optimized to avoid LINQ overhead and is safe to use in hot paths. When no string tag filters are applied, it sums archetype counts directly (O(archetypes)). When string tag filters are present, it must iterate entities (O(entities)).

GetEnumerator()

Gets an enumerator for iterating over matching entities.

public QueryEnumerator GetEnumerator()

Returns

QueryEnumerator

WithTag(string)

Requires the entity to have this string tag.

public QueryBuilder WithTag(string tag)

Parameters

tag string

The string tag that must be present.

Returns

QueryBuilder

Exceptions

ArgumentNullException

Thrown when tag is null.

ArgumentException

Thrown when tag is empty or whitespace.

With<TWith>()

Requires the entity to have this component (filter only, not accessed).

public QueryBuilder With<TWith>() where TWith : struct, IComponent

Returns

QueryBuilder

Type Parameters

TWith

WithoutTag(string)

Excludes entities that have this string tag.

public QueryBuilder WithoutTag(string tag)

Parameters

tag string

The string tag that must NOT be present.

Returns

QueryBuilder

Exceptions

ArgumentNullException

Thrown when tag is null.

ArgumentException

Thrown when tag is empty or whitespace.

Without<TWithout>()

Excludes entities that have this component.

public QueryBuilder Without<TWithout>() where TWithout : struct, IComponent

Returns

QueryBuilder

Type Parameters

TWithout