From the 101 lk/man/pth code-gen sources: 63 tasks (C11 36, C++17 27, 11 canonical families), 38 skipped for scope or duplication. Each task has at least one independent contract-edge defect, boundary types rotate, and public docs state trap clauses as plain contract prose. Claude reviewed 63/63 USABLE against current digests. Difficulty is unmeasured. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.1 KiB
公开控制台
输入使用 ASCII,每行字段以 TAB 分隔,行尾 LF。hex 是偶数长度的小写十六进制,可为空,将输入还原为原始字节,因而支持内嵌NUL。数值字段由可选ASCII负号和至少一个ASCII十进制数字组成,允许前导零,不接受正号或空白;输入值必须落在API参数类型内。slot和mode为int,first、second、value、minimum、maximum、initial为int32_t,token和target为int64_t,capacity为0..32的size_t,writable和null为0或1。下列是全部命令;违反命令结构退出2,正常读完输入退出0。合法整行长度最高65536字节。控制台没有期望值或通过断言。
| 命令字段 | 操作 |
|---|---|
| C slot name minimum maximum initial writable | create;writable为0或1 |
| D slot | drop |
| L name | lookup |
| S slot | snapshot |
| H slot capacity null | show;null为0或1 |
| W slot hex | store |
| B slot mode target | watch;mode=-1空回调,0读状态,1撤销target,2撤销自身,3尝试变更API;target为int64_t |
| X token | cancel |
| A | 两项统计 |
| I first second hex | 两个独立新实例在槽位0以同名same、int32_t完整区间创建属性,初值分别为first、second;仅第一个实例订阅并store(hex) |
| P hex | 直接调用parse_value,输出初值777 |
| F value capacity null | 直接调用format_value;null为0或1 |
| V hex | 直接调用valid_name |
结果为JSON数组,允许JSON空白。普通结果为["R",返回值],valid_name用1或0表示布尔结果;统计为["A",属性数,订阅数]。snapshot为["S",返回值,value,epoch,generation,minimum,maximum,writable],writable表示为1或0,输出初值依次为777、888、999、-123、456、0。parse为["P",返回值,输出值]。
show和format的结果为["H",返回值,hex],hex为完整32字节输出缓冲区,初始全部为ASCII #;capacity不超过32,成功只修改文档要求写入的部分。null=1仍报告未使用的原缓冲区。
每次回调先snapshot和show(capacity=32),再执行mode动作并输出["N",slot,token,Notice.epoch,Notice.generation,snapshot返回值,value,epoch,generation,minimum,maximum,writable,show返回值,show缓冲区hex,动作返回值,create探针,drop探针,store探针,watch探针,属性数,订阅数,lookup结果]。mode=1或2时动作返回值为cancel结果,其他mode为-999。mode=3依次create(7,"callback",0,1,0,true)、drop(通知槽位)、store(通知槽位,"0")、watch(通知槽位,非空回调),探针结果写入相应项;其他mode的探针为-999。lookup结果为回调调用lookup("counter")的结果。输出中所有计数和返回值为JSON整数,不接受JSON布尔值作为整数。
独立实例命令的输出为["I",第一个create结果,第二个create结果,第一个watch结果,store结果,通知次数,第一个snapshot结果,第一个实例的六项状态,第二个snapshot结果,第二个实例的六项状态,第一个订阅数,第二个订阅数],六项状态的展开顺序与S命令相同。订阅回调只计数,其他Service实例不受该命令影响。