Click above to get retro games delivered to your door ever month!

  Sx_FCompress():

  Syntax:   Sx_FCompress( <cSourceFile>, <cTargetFile> )

          cSourceFile = The name of the file to be compressed.  This file
                        must be CLOSED in order to be compressed.

          cTargetFile = The name to use for the newly created (compressed)
                        file.  This name MUST be different from the one
                        specified in cSourceFile.  No default file extension
                        is assumed or supplied.

  Returns:  Logical value.  TRUE (.T.) if successful, FALSE (.F.) if not.

  Description:  Compresses a file (cSourceFile), storing the compressed file
                to a new file (cTargetFile).

  Example:

    // Compress TEST.DBF, storing it to TEST.CMP

    IF !Sx_FCompress( "TEST.DBF", "TEST.CMP" )
      Alert( "ERROR: File Compression Failure!" )
      Return( .F. )
    ENDIF

    Return( .T. )


  NOTE:  This function does nothing to verify that a file of the same name
         as cTargetFile does not already exist.  Thus, any existing file of
         the same name will be unceremoniously overwritten with the new file.
         If this is not the desired result, use CA-Clipper's FILE() function
         to check for the existence of the file and take whatever action is
         desired prior to calling this function.