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>
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# `lib/path` — 路径代数(Mid M2)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **已落地(M2)** |
|
||
| 日期 | 2026-09-07 |
|
||
| 相关 | [stdlib-mid.md](stdlib-mid.md) · [roadmap/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 专项文档。
|