sc_game_spatial_v1.list_zones
Copied page sorted by zone ID from at most 256 explicitly observed zones, never exhaustive world discovery. epoch=0 selects current set; nonzero epoch must match. Tick refresh, additions/changes, invalidation and stop expire epochs. cap at most 64; stride is aligned to 8 bytes and in [144,4096]; every offered slot has size at least 144. cap=0 allows NULL out and counts remaining entries. offset may equal total. out_count is copied elements; out_more is remaining after this page; out_epoch pins later pages. Validate all slots before writing; preserve caller size and unknown tails. Outputs unchanged on 0.
Signature
Section titled “Signature”int (*)(uint64_t, uint32_t, sc_game_zone *, uint32_t, uint32_t, uint32_t *, uint32_t *, uint64_t *)Service and availability
Section titled “Service and availability”| Property | Value |
|---|---|
| Symbol | sc_game_spatial_v1.list_zones |
| Record ID | sc-game-spatial-v1-list-zones |
| Service | game.spatial |
| Table | sc_game_spatial_v1 |
| Version macro | SC_GAME_SPATIAL_VERSION |
| Packed table version | 65536 |
| Since / availability | size >= 40; 1.0 |
| Complete member extent (x64 bytes) | 40 |
| Table size (x64 bytes) | 40 |
Parameters and buffers
Section titled “Parameters and buffers”int (*list_zones)(uint64_t epoch, uint32_t offset, sc_game_zone* out, uint32_t stride, uint32_t cap, uint32_t* out_count, uint32_t* out_more, uint64_t* out_epoch);
Copied page sorted by zone ID from at most 256 explicitly observed zones, never exhaustive world discovery. epoch=0 selects current set; nonzero epoch must match. Tick refresh, additions/changes, invalidation and stop expire epochs. cap at most 64; stride is aligned to 8 bytes and in [144,4096]; every offered slot has size at least 144. cap=0 allows NULL out and counts remaining entries. offset may equal total. out_count is copied elements; out_more is remaining after this page; out_epoch pins later pages. Validate all slots before writing; preserve caller size and unknown tails. Outputs unchanged on 0.
Results and failures
Section titled “Results and failures”1 success; 0 invalid input, wrong thread, missing readiness, unreadable/unstreamed/incomplete ancestry, expired epoch, ambiguous name or quota refusal. All outputs unchanged on 0.
Absent capability
Section titled “Absent capability”Absent table: query_service NOT_FOUND. Missing game readiness: 0.
Ownership
Section titled “Ownership”Caller-owned copied records/buffers; opaque session IDs and epoch tokens, never pointers. Fixed 256-record storage; bounded temporary trees may allocate. No retained caller inputs or allocation transfer.
Thread affinity
Section titled “Thread affinity”Game thread only; non-reentrant; no callbacks.
Callback context
Section titled “Callback context”No callbacks.
Reentrancy
Section titled “Reentrancy”Recursive calls unsupported.
Cleanup and cancellation
Section titled “Cleanup and cancellation”Synchronous read; no cancellation. Stop clears observations and expires epochs. Table lives until plugins unload; no calls after shutdown admission.
Language mappings
Section titled “Language mappings”Status labels are copied verbatim from the catalogue: direct is native access; typed-wrapper is wrapper-backed; restricted is a subset/adaptation; unsupported means no supported route is established. No status implies universal safety.
| Language | Catalogue status | Source evidence / wrapper tokens |
|---|---|---|
| c | direct | include/sc_game_spatial.h(*list_zones) |
| cpp | direct | include/sc_game_spatial.h(*list_zones) |
| csharp | unsupported | include/sc_game_spatial.hC# and Lua unsupported |
| lua | unsupported | include/sc_game_spatial.hC# and Lua unsupported |
Examples
Section titled “Examples”None identified in the catalogue; this is not proof none can exist.
ABI pins prove layout, not semantic behavior or a live game session.