--- markup: occlusion title: 描述与细节 --- 这份文档把意图留在句子中,把细节放在侧注里。阅读和展开详情都不会运行示例中的函数,只有主动调用才会计算。 可以先看 [函数与参数](计算费用(单价=12, 数量=2)),再看 [嵌套调用](计算费用(单价=abs(-12), 数量=2)),了解每个输入来自哪里。 引用 [列表内容]([1, 2, 3]) 和 [记录内容]({"名称": "茶", "单价": 12}) 时,侧注会按内容的结构排列;[补充说明]("数量以实际购买件数为准。") 则直接呈现文字。 [待实现的步骤]() 会明确提示待补充,避免把缺失逻辑当成已经完成的工作。 通过 [跳到函数定义](#fn-16) 可以在当前文档中定位,通过 [查看阅读示例](view-reading.mq.md) 可以打开同目录文档;[访问项目仓库](https://github.com/cflmy/marqdo) 保留正常的网页跳转。 ## 计算费用 | 参数 | 类型 | 默认值 | 含义 | | --- | --- | --- | --- | | 单价 | number | 0 | 每件商品的价格 | | 数量 | number | 1 | 本次购买的件数 | | 返回值 | 类型 | 含义 | | --- | --- | --- | | 费用 | number | 单价与数量的乘积 | 调用方提供 `单价`=0 和 `数量`=1 后,可以直接按件数计算。这一示例只处理简单乘法,未包含税费、折扣或金额舍入规则,实际项目应根据业务补齐这些约定。 在确认输入符合业务要求之后,返回 *[按件数计算](单价 * 数量)*,调用方便得到了本次购买的总费用。