Files
marqdo/doc/design/call-arguments.md
T
cflmyandCursor a5d30c00b3 Add bilingual public docs, keyword aliases, and frontmatter stdin for view.
English/Chinese user pages sit side by side; L0 builtins and lib/ text|表 dual APIs land with gold coverage. Capture/view input demos use stdin:/输入: so static export and first page load succeed.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-05 09:14:26 +08:00

1.9 KiB
Raw Blame History

调用实参:具名与位置

状态 已定(v0.1 增补)
日期 2026-08-04
相关 markdown-mapping.md · keywords.md

1. 目标

> 调用同时支持:

形式 示例 说明
具名(保留) > 问候 谁=Marqdo 名=值;值可含空格(至下一 名=)
位置(新增) > 问候 Marqdo 按形参声明顺序绑定

二者可混用:位置实参按「尚未被具名绑定的形参」从左到右填充。具名不可绑定同一形参两次;位置实参不得出现在「已出现具名实参」之后(对齐常见「位置在前、关键字在后」习惯)。


2. 文法(调用尾部)

call_tail  ::= callee arg*
arg        ::= named | positional
named      ::= ident '=' value
positional ::= value_token
  • value(具名右侧):可含空格与 `var` 插值,直到下一个 ident= 边界。
  • value_token(位置):空白分隔的一个词法单元——数字、`名`、标识/文本词;不含空格。多词字符串请用具名,例如 > print text=Hello World!。
  • 内置 print / 打印 形参:text ≡ 内容。
  • input / 输入:prompt ≡ 提示。
  • len / 长度、str / 文本、int / 整数:value ≡ 值。
  • 完整中英双名见 keywords-i18n.md。

3. 绑定算法

  1. 收集具名 → 映射;冲突则报错。
  2. 按函数形参表顺序:若具名已提供则用之,否则取下一个位置实参。
  3. 位置实参有余、或必填形参仍缺 → 报错(内置 input 的 prompt 可缺省)。
  4. 用户函数:额外具名键仍写入调用环境(便于扩展);位置实参不可超过形参数目。

4. 金样例

见 tests/structure/positional-call.mq.md 与更新后的 tests/structure/import/。