Files
marqdo/examples/view-reading.mq.md
T

3.1 KiB

markup, title, description
markup title description
occlusion 在正文里读懂一段程序 用同一份源码演示动作遮蔽、输入输出、数据表、条件、循环和待补逻辑。

这份示例把计算留在文章里。动作说明可以直接阅读,展开侧注才看到实际表达式。 侧注说明“准备怎样计算”,运行标注说明“这一次得到什么”;两种信息有不同的来源。

用 marqdo view examples/view-reading.mq.md 打开实时阅读,或执行下面的离线导出命令。 导出时的 --no-exec 只分析和排版,不运行示例,也不触发任何动作。

marqdo view output examples/view-reading.mq.md --no-exec --out /tmp/marqdo-reading

计算小计

参数 类型 默认 说明
单价 number 必填 每件商品的价格,使用调用方选定的同一种货币单位
数量 number 1 购买的件数;本例由调用方保证非负
返回 类型 说明
小计 number 单价乘以数量得到的金额,不包含额外税费或优惠

已知商品的单价,未指定时购买数量=1。这里没有网络请求或文件写入; 价格与数量由调用者提供,不会从屏幕上的说明自动推测。 完成乘法后,我们返回*[按件数计算金额](单价 * 数量)*,让后面的步骤继续使用。

预留逻辑

返回 类型 说明
结果 any 当前返回 None;尚未接入实际业务实现

此函数演示空遮蔽的显示。它没有实现业务行为,不能作为“功能已完成”的证据。 目前返回*由作者补充具体业务*;阅读器会明确标出待补逻辑,而不会假装已有结果。

main

返回 类型 说明
结果 map 两笔金额与遍历计算的总数,均来自这一次实际执行

先第一笔 = [购买两件商品](计算小计(单价=12, 数量=2)),再第二笔 = 使用默认件数。 两个动作可以在同一句话里出现,各自关联自己的逻辑侧注。金额的实际数值只在运行后产生。

下面的单列表是三个数量组成的列表;绑定名让它成为数据,和上面的参数契约表不同。

数量列表 =

数量
1
2
3

从总数 = 0开始累计,每次迭代读取一个值。切换迭代记录只是在查看既有结果,不会重跑循环。

  • [依次累计数量](遍历 数量列表 为 项) 把当前项加入已有累计,得到总数 = 总数 + 项。

下面按计算结果选择分支;未进入的分支仍然属于源码,不会因为查看运行记录而消失。

  1. 总数 > 0 确认这次遍历已有数据后,执行**输出累计值**。

没有数量时,执行**说明输入为空**。

把已经计算的值整理成一行记录,字段名称说明每一项的来源。

摘要 =

第一笔 第二笔 总数
第一笔 第二笔 总数

最后返回摘要,调用者得到的是结构化记录;上面的预留函数并未在本流程中调用。