Files
marqdo/doc/design/stdlib-table.md
T
cflmyandCursor 687c168014 feat(parse): use nested YAML import: maps instead of one-liner binds
Frontmatter imports are now valid YAML (`import:` / `导入:` with bind→target
entries), removing spaced keys. Add `marqdo migrate imports`, hard-error the
old one-liner form, and migrate lib/ext/examples/tests/docs accordingly.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 19:33:58 +08:00

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