Ship fs/time/sys/json/net L1 libs (plus existing text/table), default-on host caps with soft exit under view, bilingual public/stdlib docs, and design notes for deferred math/foreign. Co-authored-by: Cursor <cursoragent@cursor.com>
97 lines
3.0 KiB
Markdown
97 lines
3.0 KiB
Markdown
# 标准库(P2)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **S0–S3 落地** |
|
||
| 日期 | 2026-08-04 |
|
||
| 相关 | [keywords.md](keywords.md) · [call-arguments.md](call-arguments.md) · [stdlib-i18n.md](stdlib-i18n.md) · [stdlib-modules.md](stdlib-modules.md) · [roadmap/next-phase.md](../roadmap/next-phase.md) |
|
||
|
||
> **多语言库命名**:见 [stdlib-i18n.md](stdlib-i18n.md)(不设 `lang:`;中英分文件)。
|
||
> **下一波模块(本波:文件 / 系统 / 时间 / JSON / 网络;数学·外联暂缓)**:见 [stdlib-modules.md](stdlib-modules.md)。
|
||
|
||
---
|
||
|
||
## 1. 分层
|
||
|
||
| 层 | 内容 |
|
||
|----|------|
|
||
| **L0 内置** | 解释器内:`print` `input` `len` `str` `int` `type` `trim` `split` `join` `at` |
|
||
| **L1 官方库** | 仓库根目录 [`lib/`](../../lib/)(`.mq.md`);可用 `lib/…` 或别名 `std/…` 导入 |
|
||
| **L2** | catalog / 用户站收录(随发版) |
|
||
|
||
---
|
||
|
||
## 2. 内置一览(S0 + S1)
|
||
|
||
| 名 | 形参 | 结果 |
|
||
|----|------|------|
|
||
| `len` | `value` | 文本标量数或列表长度 |
|
||
| `str` | `value` | 显示文本 |
|
||
| `int` | `value` | 整数(失败 → 诊断) |
|
||
| `type` | `value` | `none`/`bool`/`int`/`text`/`list` |
|
||
| `trim` | `value` | 去首尾空白 |
|
||
| `split` | `value`, `sep` | 文本列表 |
|
||
| `join` | `value`, `sep` | 拼接文本 |
|
||
| `at` | `value`, `index` | 列表下标(越界 → `None`) |
|
||
|
||
表(单列表格)在运行时是 `list`:行数用 `len`,取行用 `at`。
|
||
|
||
---
|
||
|
||
## 3. 官方库导入(S2)
|
||
|
||
Frontmatter:
|
||
|
||
```markdown
|
||
---
|
||
> lib/text.mq.md
|
||
> lib/table.mq.md
|
||
---
|
||
```
|
||
|
||
`std/text.mq.md` 等价于 `lib/text.mq.md`。解析顺序:
|
||
|
||
1. 相对当前文件
|
||
2. `MARQDO_LIB`(可指向 `lib` 目录或仓库根)
|
||
3. 当前工作目录的 `lib/`
|
||
4. 可执行文件附近的 `lib/`(含 `cargo run` 的相对路径)
|
||
|
||
当前模块:
|
||
|
||
| 路径 | 导出函数 |
|
||
|------|----------|
|
||
| `lib/fs.mq.md` / `lib/文件.mq.md` | `read_text`… / `读文本`… |
|
||
| `lib/time.mq.md` / `lib/时间.mq.md` | `now_unix`… / `此刻秒`… |
|
||
| `lib/sys.mq.md` / `lib/系统.mq.md` | `env_get`… / `取环境`… |
|
||
| `lib/json.mq.md` | `parse` `stringify` `get` `keys`(中英同文件) |
|
||
| `lib/net.mq.md` / `lib/网络.mq.md` | `http_get`… / `获取`… |
|
||
| `lib/text.mq.md` | `str_trim` `str_split` `str_join` |
|
||
| `lib/文本.mq.md` | `去空白` `拆分` `拼接` |
|
||
| `lib/table.mq.md` | `rows` `row_at` |
|
||
| `lib/表.mq.md` | `行数` `取行` |
|
||
|
||
规划中的 L1 扩展见 [stdlib-modules.md](stdlib-modules.md)。
|
||
|
||
---
|
||
|
||
## 4. 转换错误约定(S3)
|
||
|
||
用户可见失败统一为:
|
||
|
||
```text
|
||
path:line:col: message
|
||
```
|
||
|
||
内置转换相关文案(稳定子集,金样例断言):
|
||
|
||
| 情况 | message |
|
||
|------|---------|
|
||
| 非法整数文本 | `cannot convert to int: "…"` |
|
||
| `int` 类型不对 | `int needs int, bool, or text` |
|
||
| `len` 类型不对 | `len needs text or list` |
|
||
| `trim` 非文本 | `trim needs text` |
|
||
| `split`/`join` 参数类型 | `split needs text value` 等 |
|
||
| 空分隔符 | `split sep must not be empty` |
|
||
|
||
不引入独立异常类型对象;一律走 `Diagnostic`。
|