docs / stdlib / wire

Decompressor

cajeta.wire.Decompressor is the decompress stage of a byte-to-byte codec, the inverse of Compressor. A block container knows each block’s decompressed length and passes it as expandedLen. A transport that does not, such as HTTP content coding, passes a cap instead, and the codec raises DecompressionLimitException rather than produce more.

import cajeta.wire.Decompressor;
import cajeta.wire.DecompressionLimitException;

// A pass-through codec showing the contract's shape.
public final class CopyDecompressor implements Decompressor {
    public CopyDecompressor() { }

    static #int8[] take(int8[] src, int64 len) {
        int8[] out = heap int8[len];
        int64 i = 0;
        while (i < len) {
            out[i] = src[i];
            i = i + 1;
        }
        return #out;
    }

    public #int8[] decompress(int8[] src, int64 expandedLen) {
        return CopyDecompressor.take(src, expandedLen);
    }

    public #int8[] decompress(int8[] src, int64 len, int64 maxOut) {
        if (len > maxOut) {
            throw heap DecompressionLimitException("output over the cap", maxOut);
        }
        return CopyDecompressor.take(src, len);
    }
}

Methods

⚑ = @EntryPoint

See also

• Compressor, the inverse stage
• DecompressionLimitException
• Source: runtime/src/cajeta/wire/Decompressor.cajeta

Source: docs/stdlib/wire/Decompressor.md · 1 min read · 121 words