Files
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

2.5 KiB
Executable File
Raw Permalink Blame History

lib/table / lib/表 — 列表与字典

状态 已落地(可用级集合 API)
相关 stdlib.md · stdlib-modules.md · table-cell-expressions.md · roadmap/tables-maps-footnotes.md

1. 读写对

读 写
链接取元 [key](xs) / [key](m) / 嵌套 [1]([a](m))(脚注 `m`[^k] 仍兼容) table.put / 表.改

put / 改 的 at=(于=)与取元同构:文本键、1-based 整数下标,或键/下标组成的路径列表。

---
import:
  table: lib/table.mq.md
---

# main

**`h` = [table.put] in=None at="Authorization" value="Bearer-x"**

`xs` =

| v |
|---|
| a |
| b |

**`xs` = [table.put] in=`xs` at=1 value="A"**
**打印 内容=[Authorization](h)**

in=None 且 at= 为单个文本键 → 新建单键字典。值一律不可变更新(返回新集合)。


2. 索引约定

API 基数
put / 改 路径中的整数;脚注 [^n] 1-based
at / row_at / set_at / insert / remove_at / slice / index_of 0-based

3. API 摘要(EN ↔ ZH)

EN ZH 说明
put 改 按路径改一元(首选写入)
len / rows 长度 / 行数 长度
at / row_at 取 / 取行 0-based 取元
append / prepend / concat 追加 / 前插 / 拼接 列表
insert / set_at / remove_at / pop 插入 / 改位 / 删位 / 弹出 列表位操作
first / last / slice 首 / 末 / 切片
contains / index_of / reverse 含有 / 下标 / 反转
clear 清空 列表或字典
get / set / delete / has 取键 / 设 / 删键 / 有键 浅层字典
keys / values / items / merge / size 键表 / 值表 / 项表 / 合并 / 键数
empty_list / empty_map 空表 / 空字典

嵌套改写优先 put/改;set/set_at 仅浅层。


4. 与 lib/json

用途 用
解析 / 序列化 / quote json.parse · json.stringify · json.quote
集合读写 table.* / 表.*
兼容 json.set / json.append / json.get / json.keys 仍为别名,新代码勿依赖

5. 宿主

host_collection_put + list/map 原语(见 src/host/collection.rs)。作者面经 lib/table / lib/表 调用,不直接写 host_*。