PowerBuilder

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.

PowerBuilder

integer li_rc
integer li_Success
oleobject loo_Zip
oleobject loo_Entry
oleobject loo_Sb
integer li_LineEndingBehavior
string ls_SrcCharset

li_Success = 0

loo_Zip = create oleobject
li_rc = loo_Zip.ConnectToNewObject("Chilkat.Zip")
if li_rc < 0 then
    destroy loo_Zip
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Open an existing ZIP archive.
li_Success = loo_Zip.OpenZip("qa_data/zips/configFiles.zip")
if li_Success = 0 then
    Write-Debug loo_Zip.LastErrorText
    destroy loo_Zip
    return
end if

// Locate the JSON file entry within the ZIP archive.
loo_Entry = create oleobject
li_rc = loo_Entry.ConnectToNewObject("Chilkat.ZipEntry")

li_Success = loo_Zip.EntryOf("config/settings.json",loo_Entry)
if li_Success = 0 then
    Write-Debug "ZIP entry not found."
    loo_Zip.CloseZip()
    destroy loo_Zip
    destroy loo_Entry
    return
end if

// ------------------------------------------------------------
// Inflate the ZIP entry directly into a StringBuilder.
// 
// The uncompressed text is appended to the StringBuilder.
// 
loo_Sb = create oleobject
li_rc = loo_Sb.ConnectToNewObject("Chilkat.StringBuilder")

// Leave line endings unchanged.
li_LineEndingBehavior = 0

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

li_Success = loo_Entry.UnzipToSb(li_LineEndingBehavior,ls_SrcCharset,loo_Sb)
if li_Success = 0 then
    Write-Debug loo_Entry.LastErrorText
    destroy loo_Zip
    destroy loo_Entry
    destroy loo_Sb
    return
end if

Write-Debug "Uncompressed text:"
Write-Debug ""
Write-Debug loo_Sb.GetAsString()

loo_Zip.CloseZip()

Write-Debug "Done."


destroy loo_Zip
destroy loo_Entry
destroy loo_Sb