Function ecs_get_stage
Synopsis
#include <include/flecs.h>
FLECS_API ecs_world_t * ecs_get_stage(const ecs_world_t *world, int32_t stage_id)
Description
Get stage-specific world pointer. Flecs threads can safely invoke the API as long as they have a private context to write to, also referred to as the stage. This function returns a pointer to a stage, disguised as a world pointer.
Note that this function does not(!) create a new world. It simply wraps the existing world in a thread-specific context, which the API knows how to unwrap. The reason the stage is returned as an ecs_world_t is so that it can be passed transparently to the existing API functions, vs. having to create a dediated API for threading.
- Parameters
world
- The world.stage_id
- The index of the stage to retrieve.- Returns
- A thread-specific pointer to the world.
Source
Line 2820 in include/flecs.h.