跳转至

miniz - 简易zlib压缩

{bdg-success}已适配 {bdg-primary}Air780E {bdg-primary}Air780EP {bdg-primary}Air780EPS {bdg-primary}Air780EQ {bdg-primary}Air700EAQ {bdg-primary}Air700EMQ {bdg-primary}Air700ECQ {bdg-primary}Air201

本页文档由[这个文件](https://gitee.com/openLuat/LuatOS/tree/master/luat/../components/miniz/luat_lib_miniz.c)自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!

示例

-- 准备好数据
local bigdata = "123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaios;hfiuoaghfluaeisw"
-- 压缩之, 压缩得到的数据是zlib兼容的,其他语言可通过zlib相关的库进行解压
local cdata = miniz.compress(bigdata) 
-- lua 的 字符串相当于有长度的char[],可存放包括0x00的一切数据
if cdata then
    -- 检查压缩前后的数据大小
    log.info("miniz", "before", #bigdata, "after", #cdata)
    log.info("miniz", "cdata as hex", cdata:toHex())

    -- 解压, 得到原文
    local udata = miniz.uncompress(cdata)
    log.info("miniz", "udata", udata)
end

常量

常量 类型 解释
miniz.WRITE_ZLIB_HEADER int 压缩参数,是否写入zlib头部数据,compress函数的默认值
miniz.COMPUTE_ADLER32 int 压缩/解压参数,是否计算/校验adler-32
miniz.GREEDY_PARSING_FLAG int 压缩参数,是否快速greedy处理, 默认使用较慢的处理模式
miniz.NONDETERMINISTIC_PARSING_FLAG int 压缩参数,是否快速初始化压缩器
miniz.RLE_MATCHES int 压缩参数, 仅扫描RLE
miniz.FILTER_MATCHES int 压缩参数,过滤少于5次的字符
miniz.FORCE_ALL_STATIC_BLOCKS int 压缩参数,是否禁用优化过的Huffman表
miniz.FORCE_ALL_RAW_BLOCKS int 压缩参数,是否只要raw块
miniz.PARSE_ZLIB_HEADER int 解压参数,是否处理zlib头部,uncompress函数的默认值
miniz.HAS_MORE_INPUT int 解压参数,是否还有更多数据,仅流式解压可用,暂不支持
miniz.USING_NON_WRAPPING_OUTPUT_BUF int 解压参数,解压区间是否够全部数据,,仅流式解压可用,暂不支持
miniz.COMPUTE_ADLER32 int 解压参数,是否强制校验adler-32

miniz.compress(data, flags)

快速压缩,需要165kb的系统内存和32kb的LuaVM内存

参数

传入值类型 解释
string 待压缩的数据, 少于400字节的数据不建议压缩, 且压缩后的数据不能大于32k.
flags 压缩参数,默认是 miniz.WRITE_ZLIB_HEADER , 即写入zlib头部

返回值

返回值类型 解释
string 若压缩成功,返回数据字符串, 否则返回nil

例子

local bigdata = "123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaios;hfiuoaghfluaeisw"
local cdata = miniz.compress(bigdata)
if cdata then
    log.info("miniz", "before", #bigdata, "after", #cdata)
    log.info("miniz", "cdata as hex", cdata:toHex())
end

miniz.uncompress(data, flags)

快速解压,需要32kb的LuaVM内存

参数

传入值类型 解释
string 待解压的数据, 解压后的数据不能大于32k
flags 解压参数,默认是 miniz.PARSE_ZLIB_HEADER , 即解析zlib头部

返回值

返回值类型 解释
string 若解压成功,返回数据字符串, 否则返回nil

例子

local bigdata = "123jfoiq4hlkfjbnasdilfhuqwo;hfashfp9qw38hrfaios;hfiuoaghfluaeisw"
local cdata = miniz.compress(bigdata)
if cdata then
    log.info("miniz", "before", #bigdata, "after", #cdata)
    log.info("miniz", "cdata as hex", cdata:toHex())

    local udata = miniz.uncompress(cdata)
    log.info("miniz", "udata", udata)
end