Files
marqdo/doc/design/stdlib-table.md
T
cflmyandCursor 25b7be6739 Add usable table/map stdlib with put, and show run bindings in view.
Authors can update nested collections via table.put/表.改 instead of json.set chains; view’s right rail adds collapsible Variables from the entry env.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-12 11:49:48 +08:00

2.4 KiB
Raw Permalink Blame History

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

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

1. 读写对

读 写
脚注 `xs`[^1] / `m`[^key] / 嵌套 `m`[^a][^1] table.put / 表.改

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

---
> 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*

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_*。