sc_entities_v1.find_class

Find an exact case-sensitive class name in the complete copied registry; return a host session class identity, never a native pointer.

Signature

sco_result (*)(const char *, sc_entity_class_record *)

Service and availability

Service index

Property	Value
Symbol	`sc_entities_v1.find_class`
Record ID	`sc-entities-v1-find-class`
Service	game.entities
Table	sc_entities_v1
Version macro	SC_ENTITIES_VERSION_1_2
Packed table version	65538
Since / availability	`size >= 112`; 1.2
Complete member extent (x64 bytes)	112
Table size (x64 bytes)	128

Header source

Parameters and buffers

sco_result (*find_class)(const char* name, sc_entity_class_record* out);
Find an exact case-sensitive class name in the complete copied registry; return a host session class identity, never a native pointer.

Results and failures

OK copied observation; BAD_ARG invalid name/kind/output/capacity; WRONG_THREAD; NOT_FOUND stale epoch or absent item; FAILED malformed/ambiguous provider; UNAVAILABLE unbound/stopped. Known output prefix zeroed on failure, size/tail preserved.

Absent capability

game.entities.lookup OFF; no native registry/name/component adapter, not run in game.

Ownership

Caller-owned copied outputs; host session identities only, no native pointers or allocation across ABI.

Thread affinity

Game thread only.

Callback context

No plugin callbacks; synchronous bounded host backend.

Reentrancy

Recursive backend entry FAILED; stop during callback invalidates output.

Cleanup and cancellation

No retained plugin resource. Stop invalidates admission and epochs; requery session/streaming observations before use.

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_entities.h `(*find_class)`
cpp	typed-wrapper	include/scosdk/game/entities.hpp `t_->find_class(`
csharp	unsupported	docs/game/entities.md `1.2 tails: C# and Lua unsupported`
lua	unsupported	docs/game/entities.md `1.2 tails: 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.