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>
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 调用实参:具名与位置
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | 已定(v0.1 增补) |
|
||
| 日期 | 2026-08-04 |
|
||
| 相关 | [markdown-mapping.md](markdown-mapping.md) · [keywords.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](keywords-i18n.md)。
|
||
|
||
---
|
||
|
||
## 3. 绑定算法
|
||
|
||
1. 收集具名 → 映射;冲突则报错。
|
||
2. 按函数形参表顺序:若具名已提供则用之,否则取下一个位置实参。
|
||
3. 位置实参有余、或必填形参仍缺 → 报错(内置 `input` 的 `prompt` 可缺省)。
|
||
4. 用户函数:额外具名键仍写入调用环境(便于扩展);位置实参不可超过形参数目。
|
||
|
||
---
|
||
|
||
## 4. 金样例
|
||
|
||
见 `tests/structure/positional-call.mq.md` 与更新后的 `tests/structure/import/`。
|