sc_entities_v1.find_by_name

Debug-grade ASCII case-insensitive entity name lookup; ambiguous matches FAILED, missing NOT_FOUND, output zero on failure.

Signature

sco_result (*)(const char *, uint64_t *)

Service and availability

Service index

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

Header source

Parameters and buffers

sco_result (*find_by_name)(const char* name, uint64_t* out_entity_id);
Debug-grade ASCII case-insensitive entity name lookup; ambiguous matches FAILED, missing NOT_FOUND, output zero on failure.

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_by_name)`
cpp	typed-wrapper	include/scosdk/game/entities.hpp `t_->find_by_name(`
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.