Files
marqdo/doc/design/stdlib.md
cflmyandCursor a53ebb65ee Add host stdlib modules and unify view/run capabilities.
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>
2026-08-05 10:03:54 +08:00

3.0 KiB
Raw Permalink Blame History

标准库(P2)

状态 S0–S3 落地
日期 2026-08-04
相关 keywords.md · call-arguments.md · stdlib-i18n.md · stdlib-modules.md · roadmap/next-phase.md

多语言库命名:见 stdlib-i18n.md(不设 lang:;中英分文件)。
下一波模块(本波:文件 / 系统 / 时间 / JSON / 网络;数学·外联暂缓):见 stdlib-modules.md。


1. 分层

层 内容
L0 内置 解释器内:print input len str int type trim split join at
L1 官方库 仓库根目录 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:

---
> 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。


4. 转换错误约定(S3)

用户可见失败统一为:

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。