From 561a3a77de527a25b71c1029ab6e96c81286e046 Mon Sep 17 00:00:00 2001 From: silly-spongus <159207316+silly-spongus@users.noreply.github.com> Date: Sun, 29 Sep 2024 04:13:21 -0300 Subject: [PATCH] Update query.md --- docs/api/query.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/docs/api/query.md b/docs/api/query.md index 51abee5..3b4a40e 100644 --- a/docs/api/query.md +++ b/docs/api/query.md @@ -2,23 +2,21 @@ A World contains entities which have components. The World is queryable and can be used to get entities with a specific set of components. -To create a query, you must utilize [`world:query`](world). +# Methods -## Methods - -### drain +## drain This method will impede it from being reset when the query is being iterated. ```luau function query:drain(): Query ``` -### next +## next Get the next result in the query. Drain must have been called beforehand or otherwise it will error. ```luau function query:next(): Query ``` -### with +## with Adds components (IDs) to query with, but will not use their data. This is useful for Tags or generally just data you do not care for. ```luau @@ -48,7 +46,7 @@ for (const [id, position] of world.query(Position).with(Velocity)) { Put the IDs inside of `world:query()` instead if you need the data. ::: -### without +## without Removes entities with the provided components from the query. ```luau @@ -73,7 +71,7 @@ for (const [entity, position] of world.query(Position).without(Velocity)) { ``` ::: -### replace +## replace This function takes a callback which is given the current queried data of each matching entity. The values returned by the callback will be set as the new data for each given ID on the entity. ```luau function query:replace( @@ -98,7 +96,7 @@ world ``` ::: -### archetypes +## archetypes Returns the matching archetypes of the query. ```luau function query.archetypes(): { Archetype }