Add lib/re and lib/encoding (EN/ZH) backed by host_re_* and host_encoding_*, with golds, public demos, and design docs. Co-authored-by: Cursor <cursoragent@cursor.com>
33 lines
1.2 KiB
Markdown
33 lines
1.2 KiB
Markdown
# `lib/encoding` — 编解码(Mid M1)
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **已落地(M1)** |
|
||
| 日期 | 2026-09-07 |
|
||
| 相关 | [stdlib-mid.md](stdlib-mid.md) · [stdlib-re.md](stdlib-re.md) · [roadmap/stdlib-mid.md](../roadmap/stdlib-mid.md) |
|
||
| 导入 | `lib/encoding.mq.md` · `lib/编码.mq.md` |
|
||
| Host | `host_encoding_*`(无第三方 crate:标准 Base64 / hex) |
|
||
|
||
---
|
||
|
||
## 1. API
|
||
|
||
| 英文 | 中文 | 形参 | 结果 |
|
||
|------|------|------|------|
|
||
| `base64_encode` | `基64编码` | `text` | 文本(UTF-8 字节 → 标准 Base64,含 `=` 填充) |
|
||
| `base64_decode` | `基64解码` | `text` | 文本(解码后须为合法 UTF-8) |
|
||
| `hex_encode` | `十六进制编码` | `text` | 小写 hex |
|
||
| `hex_decode` | `十六进制解码` | `text` | 文本(偶数字节;合法 UTF-8) |
|
||
|
||
## 2. 与 `net.url_encode` 的边界
|
||
|
||
| 能力 | 归属 |
|
||
|------|------|
|
||
| `application/x-www-form-urlencoded` 风格 | `net.url_encode` |
|
||
| Base64 / hex | **本库** |
|
||
| 百分号编解码通用版 | 可日后加 `encoding.percent_*`;本波不做 |
|
||
|
||
## 3. 刻意不做(v1)
|
||
|
||
URL-safe Base64 变体开关、忽略空白的宽松解码、二进制 `bytes` 类型(仍经 UTF-8 文本往返)。
|