xruntime/runtime_call

bool xrtCallFrameValidate(const xrtcallframe* pFrame);

/* 检查调用帧结构、参数绑定、可选参数、变长参数和关键字参数是否符合有效签名。 */
result = xrtCallFrameValidate(pFrame);

xvalue* xrtCallFrameArgument( const xrtcallframe* pFrame, size_t iIndex );

/* 按原始位置返回借用参数，越界时报告范围错误。 */
result = xrtCallFrameArgument(pFrame, iIndex);

xvalue* xrtCallFrameKeyword( const xrtcallframe* pFrame, xstrview Name );

/* 按完整名称返回借用关键字值；未提供时返回空而不设置错误。 */
result = xrtCallFrameKeyword(pFrame, Name);

xvalue* xrtCallFrameParameter( const xrtcallframe* pFrame, size_t iIndex );

/* 按有效签名的形参下标返回位置或关键字传入的借用值；可选参数缺失时返回空。 */
result = xrtCallFrameParameter(pFrame, iIndex);

void xrtCallResultInit(xrtcallresult* pResult);

callresultinit obj;
xrtCallResultInit(&obj, pResult);

void xrtCallResultClear(xrtcallresult* pResult);

/* 释放结果值但保留溢出容量，结果可以继续复用。 */
result = xrtCallResultClear(pResult);

void xrtCallResultUnit(xrtcallresult* pResult);

xrtCallResultUnit(pResult);

size_t xrtCallResultCount(const xrtcallresult* pResult);

/* 返回调用结果数量。 */
result = xrtCallResultCount(pResult);

xvalue* xrtCallResultGet( const xrtcallresult* pResult, size_t iIndex );

/* 返回指定下标借用的结果值。 */
result = xrtCallResultGet(pResult, iIndex);

bool xrtCallResultSet( xrtcallresult* pResult, size_t iIndex, const xvalue* pValue );

/* 增加值引用后替换已有下标或追加到末尾，不允许创建稀疏结果。 */
result = xrtCallResultSet(pResult, iIndex, pValue);

bool xrtCallResultSetTake( xrtcallresult* pResult, size_t iIndex, xvalue** pValue );

/* 移交值引用后替换已有下标或追加到末尾，成功时清空来源槽。 */
result = xrtCallResultSetTake(pResult, iIndex, pValue);

bool xrtCallResultPush( xrtcallresult* pResult, const xvalue* pValue );

/* 增加值引用后追加一个结果。 */
result = xrtCallResultPush(pResult, pValue);

bool xrtCallResultPushTake( xrtcallresult* pResult, xvalue** pValue );

/* 移交值引用后追加一个结果。 */
result = xrtCallResultPushTake(pResult, pValue);

bool xrtCallResultMove( xrtcallresult* pTarget, xrtcallresult* pSource );

/* 释放目标原值并把完整结果所有权移动到目标。 */
result = xrtCallResultMove(pTarget, pSource);

xrtcallable* xrtCallableCreate( const xrtfunctionsig* pSignature, xrtcallproc pEntry, ptr pEnvironment, xrtcalldrop pDropEnvironment );

/* 创建不可变 callable；签名可以为空，非空签名及其引用必须覆盖 callable 生命周期。 */
xhandle* h = xrtCallableCreate(pSignature, pEntry, pEnvironment, pDropEnvironment);

xrtcallable* xrtCallableRef(xrtcallable* pCallable);

/* 增加或释放 callable 引用，最后一个引用负责释放环境。 */
result = xrtCallableRef(pCallable);

;

/* XRT_API void xrtCallableUnref(xrtcallable* pCallable); */
result = xrtCallableUnref();

const xrttype* xrtTypeCallable(void);

/* 返回拥有一个 callable 强引用的 C ABI 槽类型描述。 */
result = xrtTypeCallable();

const xrtfunctionsig* xrtCallableSignature( const xrtcallable* pCallable );

/* 返回 callable 借用的签名；动态 callable 可以返回空。 */
result = xrtCallableSignature(pCallable);

uint64 xrtCallableSignatureId(const xrtcallable* pCallable);

/* 返回 callable 的稳定签名 ID；动态 callable 返回零。 */
result = xrtCallableSignatureId(pCallable);

;

/* XRT_API bool xrtCallableInvoke( const xrtcallable* pCallable, const xrtcallframe* pFrame, xrtcallresult* pResult ); */
result = xrtCallableInvoke();