MarqdoEXECUTABLE KNOWLEDGE

lib/表 — 列表与字典ok

stdlib/表.mq.md

文档

怎样读这份可执行文档

正文说明意图,标记指出哪些片段会执行。遮蔽只在正文显示动作说明,实际逻辑放在侧注;阅读、展开与定位都不会运行代码。

标记阅读含义
无标记文字作者的解释,按普通 Markdown 阅读。
空行分隔叙述与结构,不是计算步骤。
# / ##一级标题声明对象或入口,更深标题声明函数;说明按钮可查看输入、返回与依据。
>调用函数;实际执行结果另有标注。
1. 递增按条件选择分支,不是普通编号说明。
-重复或遍历结构;迭代选择器只切换已有运行记录。
+ `名`兼容的显式形参;新库优先在叙述中声明参数,标题下的表格解释契约。
GFM 表未绑定的契约表是说明;绑定表按列、行和 @ 形态构成数据。
```lang代码块;绑定的外语代码与普通示例区分展示,数学公式另有公式卡片。
--- / ***分隔内容,不能把分隔线当作函数返回。
<!-- marqdo-out -->程序写回的结果,区别于作者原始正文。
`名`叙述中的参数或变量;默认值跟在名称之后。
**…**执行语句:赋值、调用或计算;不是打印,也不是返回。
*…*返回表达式;句中以返回、Return 等明确引出。
*None* / ****显式返回空值或结束当前函数。
[键](集合)正文显示描述,侧注按函数与参数、可跳转链接、结构化内容展示括号内的细节;空括号表示待补充实际逻辑。阅读不会执行调用。classic 模式保留旧链接取元。
修饰… [函数] …兼容的带修饰调用;不能把任意普通链接当作执行授权。
集合[^键]兼容的脚注取元;当前库优先用 access 读取集合。
*仅* / **说明**普通强调仍属于文字;界面按真实解析结果区分强调、语句与返回。
表:lib/表.mq.md

main

说明
返回类型说明
resultany空值;按顺序执行本页的演示步骤,观察输出或已说明的副作用。

先用一列表格表示两个文本元素,再替换第一项并保存返回的新列表。集合更新是不可变操作,若忽略返回值,原变量就仍指向旧数据。改操作的路径位置从一开始,而取行的 i 从零开始;本例刻意把两者并排展示,以免读者把不同接口的索引约定混为一谈。

更新后的第一项为甲改,列表长度仍为二,取行返回同一个第一项。本例不涉及文件、插件或解释器,输入与返回均是普通 Marqdo 值。真实业务可以继续组合筛选、映射和聚合;对于嵌套记录,先明确路径中每一段是字段名还是列表位置,并让缺失路径的诊断保持可见。打印只帮助观察,不会使后续函数自动获得这些值。

嵌套写入用 表.改;读元用链接取元。

xs =
v
甲
乙
我们先xs = ,供下一步使用。
函数调用替换列表第一项并保留新集合
表.改
入
`xs`
于
1
值
甲改
原始写法
表.改(入=`xs`, 于=1, 值="甲改")
源码说明 · 不是运行结果
我们先n = ,供下一步使用。
函数调用取得本步骤需要的路径或计数
表.行数
xs
`xs`
原始写法
表.行数(xs=`xs`)
源码说明 · 不是运行结果
我们先r = ,供下一步使用。
函数调用按零起点读取第一行
表.取行
xs
`xs`
i
0
原始写法
表.取行(xs=`xs`, i=0)
源码说明 · 不是运行结果
打印 内容=
函数调用1
access
参数 1
`xs`
参数 2
1
原始写法
access(xs, "1")
源码说明 · 不是运行结果
打印 内容=`n`
打印 内容=`r`
Functions
Variables
  • description text
    改 / 行数 / 取行(代码即文档试点)
  • markup text
    occlusion
  • n int
    2
  • r text
    甲改
  • title text
    lib/表 — 列表与字典
  • xs list · 2
    #value
    1甲改
    2乙
可执行知识 · 输入、返回与依据

这份文档怎样成为可调用的知识

1 个知识单元 · 10 个结构步骤。先读输入、返回与调用边界,再按需查看依赖和依据。

以下来自静态分析,不代表程序已经运行、测试通过或内容已获领域确认。实际运行见正文标注与“运行与结果”。

main程序入口
回到正文 · 第 9 行

这是程序入口或对象声明。成员函数的输入输出在各自说明中列出。

源码中的返回契约

any · 空值;按顺序执行本页的演示步骤,观察输出或已说明的副作用。

调用边界

输出文本。权限由实际运行入口授予;静态副作用信息不等于运行许可。

当前有哪些依据

语法与引用
检查通过;检查通过
契约检查
尚未检查
测试记录
没有可用记录
内容来源
尚无已核验证据
领域审阅
尚未进行领域审阅
查看本单元的结构步骤

这是源码结构,不是实际执行时序;正文引用不会因阅读而执行。

  1. 调用替换列表第一项并保留新集合
  2. 正文引用按零起点读取第一行
  3. 调用取得本步骤需要的路径或计数
  4. 调用按零起点读取第一行
  5. 调用打印
  6. 观察1
  7. 调用打印
  8. 调用打印
  9. 正文引用替换列表第一项并保留新集合
  10. 正文引用取得本步骤需要的路径或计数
技术详情:身份、摘要与原始状态
目标标识
mq://public/stdlib%2F%E8%A1%A8/type/main
制品摘要(未检查锁定状态)
sha256:a65c18c4883823ae7539f18cfe17f08ccd70748e3243a39aa8c831099f54d93e
依赖标识
原始验证状态
parse: passed; resolve: passed; contract: unchecked; execution: not_run; tests: unknown; evidence: unverified; domain: unreviewed

运行与结果

甲改 2 甲改
完整源码
---
markup: occlusion
title: lib/表 — 列表与字典
description: 改 / 行数 / 取行(代码即文档试点)
导入:
  表: lib/表.mq.md
---

# main

| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | 空值;按顺序执行本页的演示步骤,观察输出或已说明的副作用。 |

先用一列表格表示两个文本元素,再替换第一项并保存返回的新列表。集合更新是不可变操作,若忽略返回值,原变量就仍指向旧数据。改操作的路径位置从一开始,而取行的 i 从零开始;本例刻意把两者并排展示,以免读者把不同接口的索引约定混为一谈。

更新后的第一项为甲改,列表长度仍为二,取行返回同一个第一项。本例不涉及文件、插件或解释器,输入与返回均是普通 Marqdo 值。真实业务可以继续组合筛选、映射和聚合;对于嵌套记录,先明确路径中每一段是字段名还是列表位置,并让缺失路径的诊断保持可见。打印只帮助观察,不会使后续函数自动获得这些值。

嵌套写入用 表.改;读元用链接取元。

`xs` =

| v |
|---|
| 甲 |
| 乙 |

我们先**xs = [替换列表第一项并保留新集合](表.改(入=`xs`, 于=1, 值="甲改"))**,供下一步使用。
我们先**n = [取得本步骤需要的路径或计数](表.行数(xs=`xs`))**,供下一步使用。
我们先**r = [按零起点读取第一行](表.取行(xs=`xs`, i=0))**,供下一步使用。

**打印 内容=[1](access(xs, "1"))**
**打印 内容=`n`**
**打印 内容=`r`**

Variable