普贤教程 › 包参考

zlib 包

zlib 压缩（RFC 1950）

纯函数封装（无 IO、无状态），调用官方 C-FFI（M42 extern def）：

项	值
包名	`zlib`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`zlib.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 64`

安装与引入

bash

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

import zlib

所属分类教程：数据格式与编解码

公开接口

函数	参数
`zl_compress`	`data, level=6`
`zl_uncompress`	`data`
`zl_crc32`	`data`

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

函数	参数
`zl_adler32`	`data`
`zl_is_compressed`	`data`
`zl_level_valid`	`level`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/zlib —— zlib 压缩（RFC 1950）
------------------------------------------------------------
纯函数封装（无 IO、无状态），调用官方 C-FFI（M42 extern def）：
zl_compress(data, level=6) → Ok(bytes) | Err
zl_uncompress(data)        → Ok(bytes) | Err
zl_crc32(data)             → Ok(int)  （IEEE CRC-32，同 zlib.crc32）
底层：import "c/zlib" → extern def zlib_compress/uncompress/crc32
（编译轨可用；解释轨 pxi FFI 表未注册 zlib → 返回 Err，登记 PX-DEF-035）
level 0..9（0 不压缩 / 6 默认）；level 由本库先校验，避免原生 px_error 杀进程。
数据面无状态：压缩率/时长由官方 C 实现承担，纯 .px 不做二次压缩。
============================================================