Files
marqdo/examples/view-details.mq.md

1.5 KiB

markup, title
markup title
occlusion 描述与细节

这份文档把意图留在句子中,把细节放在侧注里。阅读和展开详情都不会运行示例中的函数,只有主动调用才会计算。

可以先看 [函数与参数](计算费用(单价=12, 数量=2)),再看 [嵌套调用](计算费用(单价=abs(-12), 数量=2)),了解每个输入来自哪里。

引用 [列表内容]([1, 2, 3]) 和 [记录内容]({"名称": "茶", "单价": 12}) 时,侧注会按内容的结构排列;补充说明 则直接呈现文字。

待实现的步骤 会明确提示待补充,避免把缺失逻辑当成已经完成的工作。

通过 跳到函数定义 可以在当前文档中定位,通过 查看阅读示例 可以打开同目录文档;访问项目仓库 保留正常的网页跳转。

计算费用

参数 类型 默认值 含义
单价 number 0 每件商品的价格
数量 number 1 本次购买的件数
返回值 类型 含义
费用 number 单价与数量的乘积

调用方提供 单价=0 和 数量=1 后,可以直接按件数计算。这一示例只处理简单乘法,未包含税费、折扣或金额舍入规则,实际项目应根据业务补齐这些约定。

在确认输入符合业务要求之后,返回 [按件数计算](单价 * 数量),调用方便得到了本次购买的总费用。