Tcl

Compressing and Decompressing Files Using Streaming (CompressFile / DecompressFile)

See more Compression Examples

This example demonstrates how to compress a file to a binary format and then restore it using the Chilkat.Compression class. The CompressFile method reads the source file, compresses it using the specified algorithm, and writes the result to a destination file. The DecompressFile method performs the reverse operation, restoring the original file from the compressed data.

Both operations are performed internally in streaming mode, allowing files of any size to be processed efficiently without loading the entire file into memory. The example also includes a simple verification step by comparing file sizes to confirm that the decompressed output matches the original input.

Tcl

load ./chilkat.dll

set success 0

# This example assumes the Chilkat API has already been unlocked.
# See Global Unlock Sample for sample code.

set compress [new_CkCompression]

# Use the zlib algorithm (recommended for general use)
CkCompression_put_Algorithm $compress "zlib"

# ------------------------------------------------------------------
# Compress a file
# ------------------------------------------------------------------

set inputFile "c:/temp/example.txt"
set compressedFile "c:/temp/example.txt.zlib"

set success [CkCompression_CompressFile $compress $inputFile $compressedFile]
if {$success == 0} then {
    puts "Compression failed:"
    puts [CkCompression_lastErrorText $compress]
    delete_CkCompression $compress
    exit
}

puts "File compressed successfully:"
puts "  Input:      $inputFile"
puts "  Compressed: $compressedFile"

# ------------------------------------------------------------------
# Decompress the file back to its original form
# ------------------------------------------------------------------

set decompressedFile "c:/temp/example_restored.txt"

set success [CkCompression_DecompressFile $compress $compressedFile $decompressedFile]
if {$success == 0} then {
    puts "Decompression failed:"
    puts [CkCompression_lastErrorText $compress]
    delete_CkCompression $compress
    exit
}

puts "File decompressed successfully:"
puts "  Output: $decompressedFile"

# ------------------------------------------------------------------
# Optional: Verify file sizes (basic sanity check)
# ------------------------------------------------------------------

set fac [new_CkFileAccess]

set originalSize [CkFileAccess_FileSize $fac $inputFile]
set restoredSize [CkFileAccess_FileSize $fac $decompressedFile]

puts "Original file size:   $originalSize"
puts "Restored file size:   $restoredSize"

if {$originalSize == $restoredSize} then {
    puts "Sizes match (basic verification successful)."
} else {
    puts "Warning: File sizes differ."
}


delete_CkCompression $compress
delete_CkFileAccess $fac