- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
3.8 KiB
Executable File
3.8 KiB
Executable File
调用实参:具名与位置
2026-10-23 适用范围校正:本文保留早期调用尾部规则和历史示例,不是 v2.1 全部调用语法。当前已有
f(args)及具名实参;默认紧邻](是描述包裹 payload,不再是下文所述的 Classic 取元。语法审阅与开发取舍见文档原生指导 §2,当前行为须由默认模式测试复核。
| 状态 | 已定(v0.1 增补;2026-09-14:方括号标记调用) |
| 日期 | 2026-08-07 |
| 相关 | markdown-mapping.md · keywords.md · module-namespace.md · bracket-call-modifiers.md |
1. 目标
> 调用同时支持:
| 形式 | 示例 | 说明 |
|---|---|---|
| 具名(保留) | > 问候 谁=Marqdo |
名=值;值可含空格(至下一 名=) |
| 位置(新增) | > 问候 Marqdo |
按形参声明顺序绑定 |
| 方括号标记(增补) | 礼貌 [问候] Marqdo |
[函数名] 消歧;[ 前裸词 → 名=True;见 bracket-call-modifiers.md |
二者可混用:位置实参按「尚未被具名绑定的形参」从左到右填充。具名不可绑定同一形参两次;位置实参不得出现在「已出现具名实参」之后(对齐常见「位置在前、关键字在后」习惯)。前置修饰语与显式同名具名冲突则报错。
2. 文法(调用尾部)
call_tail ::= bracket_call | classic_call
bracket_call ::= modifier* '[' callee ']' arg*
classic_call ::= callee arg*
arg ::= named | positional
named ::= ident '=' value
positional ::= value_token | '(' call_tail ')'
modifier ::= ident # 展开为 ident=True;核心不剥语言词缀
]后紧邻(→ 取元[key](collection),不是 callee 标记(见 collection-access-link.md)。- 嵌套调用:把内层整段放进
(),例如[问候] ([格式化] "x")。 value(具名右侧):可含空格与`var`插值,直到下一个ident=边界。value_token(位置):空白分隔的一个词法单元——数字、`名`、标识/文本词;不含空格。多词字符串请用具名,例如> print text=Hello World!。- 实参值中
`变量`后紧跟[^…]时按脚注取元解析(可链式),而非文本:> print text=苹果单价:水果价格[^苹果]、> print text=订单[^2][^品名]。 - 独立
>调用:裸词 = 文本字面量。 *…*/**…**段内的调用(如*x = > text.split value=src sep=","*):裸词 = 变量(Python 统一命名空间),文本字面量必须加引号(value="a,b");`名`变量形式仍合法。- 内置
print/打印形参:text≡内容。 input/输入:prompt≡提示。len/长度、str/文本、int/整数:value≡值。- 完整中英双名见 keywords-i18n.md。
3. 绑定算法
- 将前置修饰语展开为
名=True具名(与显式具名冲突则报错)。 - 收集具名 → 映射;冲突则报错。
- 按函数形参表顺序:若具名已提供则用之,否则取下一个位置实参。
- 位置实参有余、或必填形参仍缺 → 报错(内置
input的prompt可缺省)。 - 用户函数:额外具名键仍写入调用环境(便于扩展);位置实参不可超过形参数目。
4. 金样例
见 tests/structure/positional-call.mq.md、tests/structure/bracket-call.mq.md、tests/structure/ns/(点号路径 / use)与 tests/structure/import/(导入解析)。