Skip to content
sco-core SDK

sco_storage_v1.step

Moves to the next row. SCO_OK: a row is ready. SCO_NOT_FOUND: no more rows, or an id this plugin doesn’t hold. SCO_FAILED / SCO_TOO_MANY: as for exec.

Signature

Section titled “Signature”
sco_result (*)(sco_plugin *, uint64_t)

Service and availability

Section titled “Service and availability”

Service index

Property Value
Symbol sco_storage_v1.step
Record ID sco-storage-v1-step
Service sco.storage
Table sco_storage_v1
Version macro SCO_STORAGE_VERSION_1_0
Packed table version 65536
Since / availability size >= 88; 1.0
Complete member extent (x64 bytes) 88
Table size (x64 bytes) 128

Header source

Parameters and buffers

Section titled “Parameters and buffers”

sco_result (*step)(sco_plugin* self, uint64_t cursor);
Moves to the next row. SCO_OK: a row is ready. SCO_NOT_FOUND: no more rows, or an id this plugin doesn’t hold. SCO_FAILED / SCO_TOO_MANY: as for exec.

Results and failures

Section titled “Results and failures”

Absent table: query_service NOT_FOUND. Stopped: UNAVAILABLE; invalid/released self: BAD_ARG. Allocation exceptions: TOO_MANY; database errors may be FAILED. Additional failures/output state unspecified unless described in the buffer contract.

Absent capability

Section titled “Absent capability”

Absent table: query_service NOT_FOUND.

Ownership

Section titled “Ownership”

Caller buffers; inputs/SQL parameters copied during call. Host owns database/cursors; no SQLite pointer or allocation crosses the ABI.

Thread affinity

Section titled “Thread affinity”

Any thread; calls serialize per plugin. Same-call recursive reentrancy unspecified.

Callback context

Section titled “Callback context”

unspecified

Reentrancy

Section titled “Reentrancy”

unspecified

Cleanup and cancellation

Section titled “Cleanup and cancellation”

No cancellation entrypoint; ordinary unload/non-retained crash cleanup rolls back transaction and closes cursors/database. Retained-provider faults skip owner resource-release hooks and require restart; backing resources remain retained, not safe for cached calls.

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/sco_storage.h
(*step)
cpp typed-wrapper include/scosdk/storage.hpp
sco_result Next() noexcept { return detail::CanCall(t_, &sco_storage_v1::step) ? t_->step(self_, id_) : (t_ ? SCO_UNAVAILABLE : r_); }
csharp typed-wrapper sdk/csharp/Sco.Sdk/Storage.cs
public ScoResult Next() => _id == 0 ? ScoResult.NotFound : !(_s.Table != null && _s.Table->size >= (uint)((byte*)&_s.Table->step - (byte*)_s.Table + sizeof(nint)) && _s.Table->step != null) ? ScoResult.Unavailable : _s.Table->step(_s.SelfFor, _id);
lua restricted plugins/lua/sco_lua.c
r = st->step(s->self, c->id);
sdk/docs/lua.md
Cursors are the runtime’s: sql closes its cursor on every path

Examples

Section titled “Examples”

Tests

Section titled “Tests”

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