普贤教程 › 包参考

percent 包

URL 百分号编码（RFC 3986）

项	值
包名	`percent`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`percent.px`
分类	`网络与协议`
文件数 / 行数	`1 / 131`

安装与引入

bash

pxpkg init          # 首次
pxpkg add percent@0.2.0
pxpkg install

import percent

所属分类教程：网络与协议

公开接口

函数	参数
`percent_encode`	`s, safe=""`
`percent_decode`	`s`

其余 10 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`pc_is_alnum`	`c`
`pc_is_unreserved`	`c`
`pc_hex2`	`n`
`pc_hexval`	`c`
`percent_encode_path`	`s`
`percent_encode_query`	`s`
`percent_encode_kv`	`key, val`
`percent_encode_params`	`pairs`
`percent_is_encoded`	`s`
`percent_decode_form`	`s`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/percent —— URL 百分号编码（RFC 3986）
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
percent_encode(s, safe="") → Ok(str) | Err   按 UTF-8 字节 %XX 编码
percent_decode(s)          → Ok(str) | Err   %XX → UTF-8；非法转义 Err
保留字符：RFC 3986 unreserved（A-Z a-z 0-9 - _ . ~）+ 调用方 safe 集；
其余（含中文、空格、/ ? & = 等）一律 %XX 大写。
============================================================