--- markup: occlusion title: 在正文里读懂一段程序 description: 用同一份源码演示动作遮蔽、输入输出、数据表、条件、循环和待补逻辑。 --- 这份示例把计算留在文章里。动作说明可以直接阅读,展开侧注才看到实际表达式。 侧注说明“准备怎样计算”,运行标注说明“这一次得到什么”;两种信息有不同的来源。 用 marqdo view examples/view-reading.mq.md 打开实时阅读,或执行下面的离线导出命令。 导出时的 --no-exec 只分析和排版,不运行示例,也不触发任何动作。 ```sh 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))**,再**第二笔 = [使用默认件数](计算小计(单价=8))**。 两个动作可以在同一句话里出现,各自关联自己的逻辑侧注。金额的实际数值只在运行后产生。 下面的单列表是三个数量组成的列表;绑定名让它成为数据,和上面的参数契约表不同。 `数量列表` = | 数量 | |---| | 1 | | 2 | | 3 | 从**总数 = 0**开始累计,每次迭代读取一个值。切换迭代记录只是在查看既有结果,不会重跑循环。 - [依次累计数量](遍历 数量列表 为 项) 把当前项加入已有累计,得到**总数 = 总数 + 项**。 下面按计算结果选择分支;未进入的分支仍然属于源码,不会因为查看运行记录而消失。 1. `总数` > 0 确认这次遍历已有数据后,执行**[输出累计值](print(text=`总数`))**。 2. * 没有数量时,执行**[说明输入为空](print(text="没有数量"))**。 把已经计算的值整理成一行记录,字段名称说明每一项的来源。 `摘要` = | 第一笔 | 第二笔 | 总数 | |---|---|---| | `第一笔` | `第二笔` | `总数` | 最后返回*摘要*,调用者得到的是结构化记录;上面的预留函数并未在本流程中调用。