Xbase++

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.

Xbase++

LOCAL nSuccess
LOCAL oZip
LOCAL oEntry
LOCAL oSb
LOCAL nLineEndingBehavior
LOCAL cSrcCharset

nSuccess := 0

oZip := CreateObject("Chilkat.Zip")

//  Open an existing ZIP archive.
nSuccess := oZip:OpenZip("qa_data/zips/configFiles.zip")
IF (nSuccess == 0)
    ? oZip:LastErrorText
    oZip:destroy()
    RETURN
ENDIF

//  Locate the JSON file entry within the ZIP archive.
oEntry := CreateObject("Chilkat.ZipEntry")

nSuccess := oZip:EntryOf("config/settings.json", oEntry)
IF (nSuccess == 0)
    ? "ZIP entry not found."
    oZip:CloseZip()
    oZip:destroy()
    oEntry:destroy()
    RETURN
ENDIF

//  ------------------------------------------------------------
//  Inflate the ZIP entry directly into a StringBuilder.
//  
//  The uncompressed text is appended to the StringBuilder.
//  
oSb := CreateObject("Chilkat.StringBuilder")

//  Leave line endings unchanged.
nLineEndingBehavior := 0

//  Interpret the uncompressed bytes as UTF-8 text.
cSrcCharset := "utf-8"

nSuccess := oEntry:UnzipToSb(nLineEndingBehavior, cSrcCharset, oSb)
IF (nSuccess == 0)
    ? oEntry:LastErrorText
    oZip:destroy()
    oEntry:destroy()
    oSb:destroy()
    RETURN
ENDIF

? "Uncompressed text:"
? ""
? oSb:GetAsString()

oZip:CloseZip()

? "Done."

oZip:destroy()
oEntry:destroy()
oSb:destroy()