编译。接口。豫
yuyan · 28 行 · 3247 字节 · UTF-8
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
寻观「标准库」之「语言核心」之「内建类型」之书。
寻观「标准库」之「数据结构」之「字节串」之书。
「：
文言：启一编译之运，返运行号；请求乃 JSON 文，含 files（路径至文之映射）与可选之 entry。编译器名乃应用之许所授之绑定名。请求违规则抛豫言之异。运行号非应用所能造，惟宿主所予。
汉语：在宿主的隔离编译环境里启动一次编译并立即返回不透明的运行号。参数依次为：编译器名（应用许可里授权的 COMPILE 绑定名）、请求 JSON 文字（{"files":{路径:文字…},"entry":路径}，entry 缺省为 入口。豫；至多 2097152 字节）。请求违规（非 JSON、路径不合规、文件数或内容超限、入口不在 files 里、绑定未授权、并发运行过多）抛出可捕获的豫言异常。编译在宿主里异步进行，应用用 读取编译运行事件 取回过程。
：」
「启动编译运行」乃化「字符串」而化「字符串」而「字符串」也。
「：
文言：候下一事而返之；状态零为得事，一为候满而无新事，二为运已终而事已尽。事乃 JSON 文。等待毫秒在一至六万。
汉语：阻塞等待运行的下一个事件，返回（状态，事件 JSON 文字）：状态 0 得到一个事件（按发生顺序）；状态 1 等待毫秒到期而没有新事件（运行仍在进行，事件文字为空串）；状态 2 运行已终止且全部事件已取尽（事件文字为空串）。等待毫秒须在 1 至 60000。事件种类见规范：stage、output、diagnostic 是过程事件，finished 与 failed 是恰有一个的终止事件，终止事件总是最后一个事件。运行号未知或已结束、同一运行已有另一个等待者，抛出可捕获的豫言异常。
：」
「读取编译运行事件」乃化「字符串」而化「字符串」而化「整数」而（「整数」合「字符串」）也。
「：
文言：取产物之原字节；运须已成而有产物，否则抛异。
汉语：读取编译成功（finished 事件带 artifact）的 WasmGC 产物原始字节，至多 8388608 字节。运行未终止、编译失败、宿主故障或已结束，抛出可捕获的豫言异常。
：」
「读取编译产物」乃化「字符串」而化「字符串」而「字节串」也。
「：
文言：取产物之 Base64 文，同上。
汉语：读取同一个产物的 Base64 文字（标准字母表，带填充，不含换行），前提同 读取编译产物；它就是 隔离运行 接口的程序参数所需之形。
：」
「读取编译产物Base64」乃化「字符串」而化「字符串」而「字符串」也。
「：
文言：终其运而释其资，幂等；运未成则弃之。
汉语：结束一次运行并释放宿主资源（事件队列、产物字节）；幂等，运行号未知时也不报错。运行尚未开始编译则不再编译；已在编译的运行无法被打断，其结果被丢弃。结束之后再用该运行号读取事件或产物抛出可捕获的豫言异常；正在等待事件的读取者立即得到状态 2。
：」
「结束编译运行」乃化「字符串」而化「字符串」而「有」也。