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>
1.2 KiB
1.2 KiB
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 专项文档。