Files
marqdo/doc/design/stdlib-path.md
T
cflmyandCursor 94ae6713aa feat(stdlib): Mid M2 path algebra and fs copy/move/temp
Add lib/path (EN/ZH) and thicken fs with sandboxed copy_file, move,
and make_temp, with golds and public demos.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-07 20:10:12 +08:00

1.2 KiB
Raw Blame History

lib/path — 路径代数(Mid M2)

状态 已落地(M2)
日期 2026-09-07
相关 stdlib-mid.md · roadmap/stdlib-mid.md
导入 lib/path.mq.md · lib/路径.mq.md
Host host_path_*(std::path;无 I/O、不经 fs_root)

1. API

英文 中文 形参 结果
join 拼接 a, b 文本路径
split 拆分 path 组件文本列表(去空段)
file_name 文件名 path 最后一段;根路径可为空文本
parent 父目录 path 父路径文本;无父则 "."
extension 扩展名 path 不含点;无扩展名为 ""
normalize 规范化 path 清理 . / ..(纯字符串,不访问磁盘)
is_absolute 是绝对 path 布尔

2. 语义

  • 分隔符与绝对路径判定跟随 宿主 OS(Linux CI 为 /)。
  • 不做 I/O;逃逸检查仍由 lib/fs 在读写时执行。
  • join:若 b 为绝对路径,结果为 b(同 Path::join)。

3. 刻意不做(v1)

glob、符号链接解析、relative_to、Windows UNC 专项文档。