Squashed 'docs/standards/playbook/' changes from c3f8137..25d895d
25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps 2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows 98c3f30 📝 docs(agent_rules): allow plan execution on current branch 16c7230 📝 docs(prompts): define custom verify layering 8efc4dd 🐛 fix(skills): quote commit-message description bc8498f 🐛 fix(ci): install tomli for gitea tests 55cda3b 🐛 fix(tests): report missing toml parser clearly c0729c7 🐛 fix(playbook): import Optional for cli compatibility 63e24bf 📦 deps(skills): sync thirdparty skills d2f9356 🐛 fix(ci): isolate gitea workflow repos 588b81d 🐛 fix(ci): inline gitea workflow bootstrap e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts 2c5050d ♻️ refactor(skills): rename repo skills source dir f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills 234b335 ✨ feat(workflow): add superpowers planning and execution state tracking c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates 2325409 📝 docs(markdown): clarify optional markdownlint usage 214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes a22b324 📝 docs(templates): add execution and memory-bank prompt templates 223a797 📝 docs(templates): update README for Claude Code and current features 4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules 2431c9d 📝 docs: add claude_md config and use cross-platform paths d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root 6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery 6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt 9f8b6b5 📝 docs: update README and config example for Claude Code support 79cff6c 📝 docs(skills): add Claude Code platform support 452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows 7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory 64950e7 📦 deps(skills): sync thirdparty skills a2e3cb0 ✨ feat(playbook): add no_backup deploy controls 8609d59 🐛 fix(docs): repair reference catalog source links 956da11 🐛 fix(playbook): publish hidden ci test fixes 3f67754 📦 deps(skills): sync thirdparty skills 08ca87b 📦 deps(skills): add karpathy thirdparty sync 96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual 3ed5052 📦 deps(skills): sync thirdparty skills 60108dd 📦 deps(skills): sync thirdparty skills da85d4e 🐛 fix(thirdparty): prune nested project snapshots a2a697e 📦 deps(skills): sync thirdparty skills 9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills 33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields 91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update 2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline 5b9c1e3 📦 deps(skills): sync superpowers 2f2d34a 📝 docs(readme): normalize subtree command spacing 62db7db 🐛 fix(ci): serialize superpowers update and sync 3463223 🐛 fix(ci): use literal superpowers sync paths 48f6de8 📦 deps(skills): sync superpowers 4b23529 🔧 chore(ci): merge superpowers update and sync workflow a56d75b 📦 deps(skills): sync superpowers 84bcefa 🔧 chore(ci): use ci[bot] commit author name 00a07e5 📦 deps(skills): sync superpowers 7b84daf 🐛 fix(templates): enforce main loop progress tracking 51373d7 🔧 chore(ci): automate superpowers sync workflow eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block 79755c6 📦 deps(skills): sync superpowers 836d878 📦 deps(skills): sync superpowers 8216c9f 📦 deps(skills): sync superpowers 9439505 🐛 fix(playbook): address reported repo issues git-subtree-dir: docs/standards/playbook git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316
This commit is contained in:
@@ -0,0 +1,101 @@
|
||||
# Matrix And Collections
|
||||
|
||||
文档类型：语法主线
|
||||
是否可直接用于生成代码：是
|
||||
是否含已验证可执行示例：是
|
||||
是否含已验证反例：否
|
||||
遇到不确定时跳转到：[14_resultset_and_filters.md](14_resultset_and_filters.md)、[26_matrix_deep_dive.md](26_matrix_deep_dive.md)、[27_fmarray.md](27_fmarray.md)
|
||||
|
||||
手册位置：第 13 篇，共 32 篇。上一篇：[12_pitfalls.md](12_pitfalls.md)。下一篇：[14_resultset_and_filters.md](14_resultset_and_filters.md)。
|
||||
|
||||
这一篇收拢 `array(...)` 的扩展用法：顺序数组、字符串键表、嵌套数组，以及已经在当前解释器下单独验证过的矩阵样比较。
|
||||
|
||||
## 这一篇解决什么问题
|
||||
|
||||
回答“`array(...)` 在 TSL 里除了最普通的一维数组，还能怎样组织数据；哪些矩阵样写法已经稳定验证过”。
|
||||
|
||||
## 必须记住的规则
|
||||
|
||||
- `array(...)` 既可以写顺序数组，也可以写字符串键表。
|
||||
- 顺序数组下标从 `0` 开始；字符串仍然从 `1` 开始。
|
||||
- `array(...)` 可以继续嵌套，形成二维或矩阵样数据。
|
||||
- 当前解释器接受矩阵链式比较 `::>`、`::<`、`::<>`、`::==`、`::>=`、`::<=`。
|
||||
- 当前这篇只收已经单独验证过的数组 / 键表 / 矩阵样主干，不把结果集过滤和 TS-SQL 混进来。
|
||||
|
||||
## 已验证语法
|
||||
|
||||
顺序数组与字符串键表：
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
arr := array(10, 20, 30);
|
||||
hash := array("Code": "0001", "Price": 12.3);
|
||||
WriteLn("ARR0=", arr[0]);
|
||||
WriteLn("ARR1=", arr[1]);
|
||||
WriteLn("HASH=", hash["Code"]);
|
||||
```
|
||||
|
||||
已验证运行结果对应关系：
|
||||
|
||||
- `arr[0] = 10`
|
||||
- `arr[1] = 20`
|
||||
- `hash["Code"] = "0001"`
|
||||
|
||||
嵌套数组：
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
[r1, r2] := array((1, 2), (3, 4));
|
||||
WriteLn(r1[0]);
|
||||
WriteLn(r1[1]);
|
||||
WriteLn(r2[0]);
|
||||
WriteLn(r2[1]);
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- 依次输出 `1`、`2`、`3`、`4`
|
||||
- 说明 `array((1, 2), (3, 4))` 这种嵌套数组写法可以稳定通过，并可按普通数组继续读取
|
||||
|
||||
矩阵链式比较：
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
program test;
|
||||
begin
|
||||
r := array(1, 2, -1) ::< array(2, 1, 0) ::< array(3, 2, 1);
|
||||
WriteLn(r[0]);
|
||||
WriteLn(r[1]);
|
||||
WriteLn(r[2]);
|
||||
s := array(1, 2, -1) ::< 2 ::< array(3, 2, 1);
|
||||
WriteLn(s[0]);
|
||||
WriteLn(s[1]);
|
||||
WriteLn(s[2]);
|
||||
end.
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- `array(1, 2, -1) ::< array(2, 1, 0) ::< array(3, 2, 1)` 的三个元素依次输出 `1`、`0`、`1`
|
||||
- `array(1, 2, -1) ::< 2 ::< array(3, 2, 1)` 的三个元素依次输出 `1`、`0`、`0`
|
||||
- 说明矩阵链式比较会按元素位置分别得到结果数组，并且可以和标量混用
|
||||
|
||||
## 暂不在本页展开的部分
|
||||
|
||||
- 专门的结果集过滤函数
|
||||
- TS-SQL 查询与写回
|
||||
- 更大范围的矩阵函数族
|
||||
|
||||
这些内容会继续收拢到后面的进阶专题，而不是再外跳到旧目录。
|
||||
|
||||
## 跳转指引
|
||||
|
||||
- 回看基础值与索引：见 [04_values_and_literals.md](04_values_and_literals.md)
|
||||
- 回看表达式层比较：见 [07_expressions_and_operators.md](07_expressions_and_operators.md)
|
||||
- 进入结果集过滤：见 [14_resultset_and_filters.md](14_resultset_and_filters.md)
|
||||
- 进入集合运算专题：见 [25_set_operations.md](25_set_operations.md)
|
||||
- 进入矩阵深水专题：见 [26_matrix_deep_dive.md](26_matrix_deep_dive.md)
|
||||
- 进入 `FMArray`：见 [27_fmarray.md](27_fmarray.md)
|
||||
Reference in New Issue
Block a user