Struct HuffmanDecoder 

pub struct HuffmanDecoder;

Huffman 解码器：将 Huffman 压缩字节还原为原始字节

使用预计算码长分组查找表 + 二分查找实现高效解码。 对于每个符号，按码长从短到长（5-30）尝试匹配，每组内二分查找 O(log N)。

安全保证

• 严格拒绝 EOS (symbol 256)
• 填充位验证：≤7 位且全为 1（RFC 7541 §5.2）
• 解压炸弹防护：最大输出 1 MiB（1_048_576 字节）

Implementations

impl HuffmanDecoder

pub fn decode(input: &[u8]) -> Result<Vec<u8>, HuffmanDecodeError>

解码 Huffman 压缩字节为原始字节

参数

• input: Huffman 编码的字节流

返回

• Ok(Vec<u8>): 解码后的原始字节
• Err(HuffmanDecodeError): 解码失败

pub fn decode_into( input: &[u8], output: &mut Vec<u8>, ) -> Result<(), HuffmanDecodeError>

解码 Huffman 压缩字节并写入调用方提供的缓冲（热路径复用缓冲，零额外堆分配）

与 HuffmanDecoder::decode 语义完全一致，但不新分配 Vec， 供 HPACK/QPACK 解码热路径以复用缓冲的方式调用。

Trait Implementations

impl Clone for HuffmanDecoder

fn clone(&self) -> HuffmanDecoder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HuffmanDecoder

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.