sc_game_spatial_v1.find_zone

Exact case-sensitive nonempty name of at most 95 bytes; copy the unique observed match only. Ambiguous, absent or possibly truncated names refuse. Does not discover unseen zones. out->size must be at least sizeof(sc_game_zone); preserve size and unknown caller tail. Outputs unchanged on 0.

Signature

int (*)(const char *, sc_game_zone *)

Service and availability

Service index

Property	Value
Symbol	`sc_game_spatial_v1.find_zone`
Record ID	`sc-game-spatial-v1-find-zone`
Service	game.spatial
Table	sc_game_spatial_v1
Version macro	SC_GAME_SPATIAL_VERSION
Packed table version	65536
Since / availability	`size >= 32`; 1.0
Complete member extent (x64 bytes)	32
Table size (x64 bytes)	40

Header source

Parameters and buffers

int (*find_zone)(const char* name, sc_game_zone* out);
Exact case-sensitive nonempty name of at most 95 bytes; copy the unique observed match only. Ambiguous, absent or possibly truncated names refuse. Does not discover unseen zones. out->size must be at least sizeof(sc_game_zone); preserve size and unknown caller tail. Outputs unchanged on 0.

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

Absent table: query_service NOT_FOUND. Missing game readiness: 0.

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

Game thread only; non-reentrant; no callbacks.

Callback context

No callbacks.

Reentrancy

Recursive calls unsupported.

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

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 `(*find_zone)`
cpp	direct	include/sc_game_spatial.h `(*find_zone)`
csharp	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`
lua	unsupported	include/sc_game_spatial.h `C# and Lua unsupported`

Examples

None identified in the catalogue; this is not proof none can exist.

Tests

ABI pins prove layout, not semantic behavior or a live game session.