WithNone

Add excluded component types to the query.

阅读时间2 分钟

最后更新于 19 天前

Definition

Add excluded component types to the query.


public EntityQueryBuilder WithNone<T1>()

Type	Description
EntityQueryBuilder	The builder object that invoked this method.

To match the resulting query, an Entity must not have any of the query's excluded component types.

There are several ways to exclude components from a query:

WithAbsent\<T\>() matches all entities in chunks that do not have T at all.
WithDisabled\<T\>() matches chunks that must have T, but only matches entities where T is disabled.
WithNone\<T\>() matches both of the above cases: either the component isn't present at all, or it is present but disabled.

WithNone accepts up to seven type arguments. You can add more component types by chaining calls together.

To add component types that are not known at compile time, use EntityQueryBuilder.WithNone@@<c>1(</c>@@0)

Component types added using WithNone are never written to. If the ComponentType.AccessMode field of the provided component type is ComponentType.AccessMode.ReadWrite, it will be forced to ComponentType.AccessMode.ReadOnly in the final query.

Add excluded component types to the query.


public EntityQueryBuilder WithNone<T>(ref T componentTypes) where T : INativeList<ComponentType>

A list of component types that implements INativeList@@1. For example, NativeList@@1 or FixedList64Bytes

Type	Description
EntityQueryBuilder	The builder object that invoked this method.

To match the resulting query, an Entity must not have any of the query's excluded component types.

There are several ways to exclude components from a query:

WithAbsent\<T\>() matches all entities in chunks that do not have T at all.
WithDisabled\<T\>() matches chunks that must have T, but only matches entities where T is disabled.
WithNone\<T\>() matches both of the above cases: either the component isn't present at all, or it is present but disabled.

To add component types that are known at compile time, use WithNone@@@@1