Zig

Unzip a Text File Entry into a StringBuilder Using ZipEntry.UnzipToSb

See more Zip Examples

This example demonstrates how to use the ZipEntry.UnzipToSb method to inflate a text file entry directly into a StringBuilder object.

The ZIP entry is uncompressed entirely in memory and appended to the StringBuilder without creating a temporary file on disk.

This is useful when:

• Processing text files directly in memory
• Avoiding temporary filesystem files
• Reading configuration files, JSON, XML, CSV, or source code from ZIP archives
• Automatically converting line endings while inflating the text

The srcCharset argument specifies how the uncompressed bytes should be interpreted, such as:

• utf-8
• utf-16
• windows-1252

The lineEndingBehavior argument controls line-ending conversion:

• 0 — Leave line endings unchanged
• 1 — Convert all line endings to bare LF
• 2 — Convert all line endings to CRLF

Suppose the ZIP archive contains:

config/settings.json

The example inflates the JSON file directly into a StringBuilder.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    var success: bool = false;

    const zip = try chilkat.Zip.init();
    defer zip.deinit();

    // Open an existing ZIP archive.
    success = if (zip.openZip("qa_data/zips/configFiles.zip")) true else |_| false;
    if (!success) {
        std.debug.print("{s}\n", .{try zip.getLastErrorText(alloc)});
        return;
    }

    // Locate the JSON file entry within the ZIP archive.
    const entry = try chilkat.ZipEntry.init();
    defer entry.deinit();

    success = zip.entryOf("config/settings.json", entry);
    if (!success) {
        std.debug.print("ZIP entry not found.\n", .{});
        zip.closeZip();
        return;
    }

    // ------------------------------------------------------------
    // Inflate the ZIP entry directly into a StringBuilder.
    //
    // The uncompressed text is appended to the StringBuilder.
    //
    const sb = try chilkat.StringBuilder.init();
    defer sb.deinit();

    // Leave line endings unchanged.
    const line_ending_behavior = 0;

    // Interpret the uncompressed bytes as UTF-8 text.
    const src_charset = "utf-8";

    entry.unzipToSb(line_ending_behavior, src_charset, sb) catch {
        std.debug.print("{s}\n", .{try entry.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Uncompressed text:\n", .{});
    std.debug.print("\n", .{});
    std.debug.print("{s}\n", .{try sb.getAsString(alloc)});

    zip.closeZip();

    std.debug.print("Done.\n", .{});
}