豫言源码浏览器 / Source Browser

1
2
3
4
5
6
7
8
9
10
11
12
13
14

寻观「标准库」之「语言核心」之「内建类型」之书。

「：文言：为此事订一频道，柄惟此事可用；订之后所发必达，订之前所发不补。汉语：在当前持久对象内订阅具名频道，返回仅在本次事件内有效的订阅柄。订阅之后发布的消息一定送达，订阅之前已发布的不补发。频道名 1 至 64 字节，字符限 A-Z a-z 0-9 . _ : -；同一实例至多 64 个频道、每频道至多 256 个订阅，超限失败。订阅须配一次取消订阅，包括异常路径。：」
「订阅持久频道」乃化「字符串」而「字符串」也。
「：文言：以文发于诸订，依订之先后而达，每订之内保序；无此频道则返零。汉语：向频道当前的全部订阅发布文字（0 至 65536 字节，不得以字节 0xFF 起首，违者抛豫言异常），按订阅先后送达、每个订阅内保序，返回送达的订阅数；频道不存在时返回 0；因积压被断开的订阅不计入。：」
「发布持久频道文字」乃化「字符串」而化「字符串」而「整数」也。
「：文言：阻候一讯：零得文，一逾时，二频道已闭、订因积压逾一 MiB 而断或订已撤，文为其因；二之后再候仍二。汉语：阻塞直到有消息、超时（0 至 3600000 毫秒，0 为立即轮询）或订阅终结；状态 0 收到消息（文字为消息），1 超时（文字为空），2 频道已被关闭、订阅因积压超过 1 MiB 被断开或订阅已被取消（文字为原因）；状态 2 之后再等待仍返回状态 2 与同一原因。：」
「等待持久频道消息」乃化「字符串」而化「整数」而（「整数」合「字符串」）也。
「：文言：撤订而释其资，幂等；撤后再候得二。汉语：取消订阅并释放资源，幂等；取消之后再等待返回状态 2。：」
「取消订阅持久频道」乃化「字符串」而「有」也。
「：文言：闭频道，已排之讯先交，诸订得二与因；返所闭之订数；同名可复订。汉语：关闭频道：已排队的消息先交付，各订阅随后收到状态 2 及原因（至多 1024 字节）；返回被关闭的订阅数，频道不存在时为 0；同名频道之后可重新订阅。：」
「关闭持久频道」乃化「字符串」而化「字符串」而「整数」也。
「：文言：数此频道今有之订，不扰订者之候。汉语：返回频道当前的订阅数，频道不存在时为 0；不影响订阅端的等待时长。：」
「读取持久频道订阅数」乃化「字符串」而「整数」也。