豫豫言文档API ATLAS
入口包说明.html
2 模块25 名称
← 全部模块

模块 / 2

解压。豫

解压。豫

21公开名称

输入上限

公开
「整数」

文言:一条目至多一千六百万字节,出至多一亿二千八百万字节,皆宿主值桥与内存所限。汉语:输入不得超过宿主值桥的 16 MiB 交换上限;最大输出不得超过 128 MiB。

输出上限

公开
「整数」

暂无说明。

造字节串

公开
化(「列」于「整数」)而「字节串」

文言:由整数之列造字节串,小数据用。汉语:把小整数列表逐项转成单字节并连接,只用于十字节以内的固定头尾。

压入合并

公开
化(「列」于「字节串」)而化「字节串」而(「列」于「字节串」)

文言:栈顶为最新,新块入栈,若其下者不逾其倍则并之,使总复制量为 n log n。汉语:输出块按到达顺序压栈;栈顶是最新块,只要栈顶不超过新块的两倍就与新块合并,保证总复制量为 O(n log n),避免逐块整体复制。

折叠合并

公开
化(「列」于「字节串」)而化「字节串」而「字节串」

暂无说明。

取消读取

公开
化「字符串」而「有」

暂无说明。

收尾读取

公开
化「字符串」而「有」

暂无说明。

读尽解压流

公开
化「字符串」而化「整数」而(「整数」合「字节串」)

文言:逐块取解压之出,先验其长再取其字,逾限即取消而止;流败为二,尽读为零。汉语:逐块读取输出,先读块长度再决定是否复制进 Wasm;累计超过最大输出立即取消读取并返回 1,流出错返回 2,读完返回 0 与全部输出。

解压数据流

公开
化「字符串」而化「字符串」而化「整数」而(「整数」合「字节串」)

文言:数据入 Blob,由 Blob 流经原生解压流;用毕即释诸柄。汉语:把数据 Blob 的流接到原生 DecompressionStream,读尽或超限后释放读取器、输出流、转换流和源流句柄;数据 Blob 句柄由调用者释放。

校最大输出

公开
化「整数」而「有」

文言:最大输出限一至一亿二千八百万。汉语:校验最大输出范围,越界抛出豫言异常。

校输入长度

公开
化「字节串」而「有」

暂无说明。

解压原始压缩

公开
化「字节串」而化「整数」而(「整数」合「字节串」)

暂无说明。

小端四字节

公开
化「整数」而「字节串」

文言:四字节小端,值先限于零至二之三十二次方减一。汉语:把 0 至 4294967295 的整数写成 4 字节小端。

存储块头

公开
化「爻」而化「整数」而「字节串」

文言:存储块之首五字节:末标、长、长之反,皆小端。汉语:deflate 存储块头:BFINAL 与 BTYPE=00 合成一字节,随后是 LEN 与 NLEN(各两字节小端)。

存储块部件

公开
化「字符串」而化「整数」而化「整数」而化(「列」于「字符串」)而(「列」于「字符串」)

文言:存储条目分块(每块至多六万五千五百三十五字节),块头为小 Blob,块体为数据 Blob 之切片,累积句柄反序。汉语:把存储方法的数据拆成存储块:块头是新建的小 Blob,块体是原数据 Blob 的切片,全部在宿主内完成;返回按逆序累积的句柄列表,空数据也产生一个末块。

压缩包头

公开
化「有」而「字节串」

文言:十字节 gzip 首。汉语:gzip 固定头:1f 8b 08 00、四字节修改时零、XFL 零、OS 未知(ff)。

部件引用们

公开
化(「列」于「字符串」)而(「列」于「字符串」)

暂无说明。

释放诸柄

公开
化(「列」于「字符串」)而「有」

暂无说明。

造归档容器

公开
化(「列」于「字符串」)而化「整数」而化「整数」而「字符串」

文言:以首、体、尾造 gzip 容器;首与尾为本函所造,用毕即释,体部件由调用者管理。汉语:把 gzip 头、deflate 体部件列表和 CRC-32 加 ISIZE 尾拼成一个宿主 Blob,返回容器句柄;只释放本函自己创建的头、尾句柄,体部件句柄归调用者。

归档条目主流程

公开
化「字节串」而化「整数」而化「整数」而化「整数」而化「整数」而(「整数」合「字节串」)

文言:存储之出即其入,长与限、与预期皆可径较,不必启流;deflate 者先以 gzip 之法一遍而验,败则以 raw 复解一遍,分二、三与一。汉语:存储方法的输出就是输入本身,长度与最大输出、预期大小可直接比较;deflate 方法先把条目包成 gzip 容器交给原生解压流,平台校验 CRC-32 与 ISIZE,成功为状态 0;失败时再用 raw deflate 复解一遍并按同一上限累计:超限为 1,流本身损坏为 2,流合法则为 3。这样无论宿主流是先交出块还是先报错,最终状态都相同。

解压归档条目

公开
化「字节串」而化「整数」而化「整数」而化「整数」而化「整数」而(「整数」合「字节串」)

暂无说明。