(Tcl) GZip Create / Extract .gz File

Demonstrates how to compress a file to create a .gz (GZip) file.

Note: The .gz file format is a compressed file format. It contains a single file. The .gz file format is not an archive format (i.e. it does not contain a collection of files/directories such as with the .zip, .rar, or .tar file formats). GZip is often combined with TAR to create a .tgz (or .tar.gz).

Note: It is possible for a .gz to contain more than one file, but this is very uncommon.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

set gzip [new_CkGzip]

# File-to-file GZip:
# Compress "hamlet.xml" to create "hamlet.xml.gz"
set success [CkGzip_CompressFile $gzip "hamlet.xml" "hamlet.xml.gz"]
if {$success != 1} then {
    puts [CkGzip_lastErrorText $gzip]
    delete_CkGzip $gzip
    exit
}

# File-to-file ungzip
# Decompress "hamlet.xml.gz" to create "hamletOut.xml"
set success [CkGzip_UncompressFile $gzip "hamlet.xml.gz" "hamletOut.xml"]
if {$success != 1} then {
    puts [CkGzip_lastErrorText $gzip]
    delete_CkGzip $gzip
    exit
}

# File-to-string ungzip
# Decompress the contents of a .gz directly to a string variable:
# The 2nd argument indicates the charset of the character
# data after it is decompressed.

set xmlStr [CkGzip_uncompressFileToString $gzip "hamlet.xml.gz" "utf-8"]
if {$success != 1} then {
    puts [CkGzip_lastErrorText $gzip]
    delete_CkGzip $gzip
    exit
}

puts "$xmlStr"

# The Chilkat GZip API provides much more flexibility than shown
# here.  See the reference documentation at 
# http://www.chilkatsoft.com/refdoc for more information

delete_CkGzip $gzip