sc_input_v1.by_name

Copy action metadata for an exact case-sensitive action name; each action has exactly one name.

Signature

sco_result (*)(sco_plugin *, const char *, sc_input_action_info *)

Service and availability

Service index

Property	Value
Symbol	`sc_input_v1.by_name`
Record ID	`sc-input-v1-by-name`
Service	game.input
Table	sc_input_v1
Version macro	SC_INPUT_SERVICE_VERSION
Packed table version	65536
Since / availability	`size >= 32`; 1.0
Complete member extent (x64 bytes)	32
Table size (x64 bytes)	32

Header source

Parameters and buffers

sco_result (*by_name)(sco_plugin* self, const char* name, sc_input_action_info* out);
Copy action metadata for an exact case-sensitive action name; each action has exactly one name.

Results and failures

OK copied; BAD_ARG invalid self, null output or malformed input; WRONG_THREAD off the game thread; UNAVAILABLE after Stop; NOT_FOUND unknown id or name.

Absent capability

game.input.registry is ON while the static registry is published; this does not attest live dispatch.

Ownership

Caller owns outputs; metadata is copied, and no engine pointer is returned or retained.

Thread affinity

Game thread only; self must be live.

Callback context

No plugin callbacks.

Reentrancy

No engine calls or callbacks; read-only metadata lookup.

Cleanup and cancellation

StopInput withdraws the service and rejects calls through a retained table.

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_input.h `(*by_name)`
cpp	unsupported	docs/game/input.md `unsupported`
csharp	unsupported	docs/game/input.md `unsupported`
lua	unsupported	docs/game/input.md `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.