GZip Create .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.

Download Chilkat 32-bit Zip ActiveX (.msi) (includes objects for .zip, .gz, .bz2, and .Z)

Download All 32-bit Chilkat ActiveX Components (.zip)

Download All 64-bit Chilkat ActiveX Components (.zip)

LOCAL loGzip
LOCAL lnSuccess
LOCAL lcXmlStr


loGzip = CreateObject('Chilkat.Gzip')

*  Any string unlocks the component for the 1st 30-days.
lnSuccess = loGzip.UnlockComponent("Anything for 30-day trial")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loGzip.LastErrorText)
    QUIT
ENDIF

*  File-to-file GZip:
*  Compress "hamlet.xml" to create "hamlet.xml.gz"
lnSuccess = loGzip.CompressFile("hamlet.xml","hamlet.xml.gz")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loGzip.LastErrorText)
    QUIT
ENDIF

*  File-to-file ungzip
*  Decompress "hamlet.xml.gz" to create "hamletOut.xml"
lnSuccess = loGzip.UncompressFile("hamlet.xml.gz","hamletOut.xml")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loGzip.LastErrorText)
    QUIT
ENDIF

*  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.

lcXmlStr = loGzip.UncompressFileToString("hamlet.xml.gz","utf-8")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loGzip.LastErrorText)
    QUIT
ENDIF

? lcXmlStr

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