fCompress (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

Operating mode in Windows Vista (and later)

ProgressBar

See also

Constants for the external files

Functions for handling directories and external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fCurrentDir (Example)

fCurrentDir

fCurrentDrive (Example)

fDetectRemovableStorage

fDriveReady (Example)

fExtractPath (Example)

fGraphicFilter (Example)

fGraphicFilter

fImageSelect (Example)

fImageSelect

fInsertTextAtBeginning

fIsImage

fListDirectory (Example)

fReadLineRegularExpression

fReportsAndQueriesDir

fSizeUncompressed (Example)

fSizeUncompressed

fSplit

fStopCompress (Example)

fUncompress (Example)

Error codes
Operating mode in Windows Vista (and later)
ProgressBar

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fCompress (Function)

In french: fCompacte

Compresses a file. This file can be decompressed by fUncompress.

Remark: The small-size files are not likely to be compressed.

Reminder: Archiving functions (zipXXX functions) allow to manage archives in ZIP, CAB, 7z, etc.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

// Compress a file
Res = fCompress("C:\Directories\File.txt", "C:\Directories\CompressedFile.txt")

Syntax

<Result> = fCompress(<Path of file to compress> , <Path of compressed file>)

<Result>: Integer

0 if the compression was performed,
an error code (value greater than 0) otherwise.

<Path of file to compress>: Character string

Name and full (or relative) path of the file to compress (up to 260 characters). A UNC path can be used.

<Path of compressed file>: Character string

Name and full (or relative) path of compressed file (up to 260 characters). A UNC path can be used.

Remarks

Error codes

The following error codes are returned:

1: The file to compress cannot be opened.
2: Unable to create the compressed file. This error occurs if <Path of compressed file> does not exist.
4: The file cannot be compressed: the file is copied (the size of the file to compress is too small for instance).
5: Insufficient memory to perform the compression.
6: The compression was canceled by the user: fStopCompress has been executed.
7: Insufficient space to create the compressed file.

The error code message can be retrieved using the ErrorInfo function with the rrMessage constant.

Operating mode in Windows Vista (and later)

If this function does not operate properly in Windows Vista (and later), check whether the file or directory used is not in one of the system directories (Windows directory or "Program Files" directory).

In Windows Vista (and later), with the UAC mechanism (User Account Control) enabled, you must have administrator privileges to handle and/or modify the files or directories in system directories (Windows directory or "Program Files" directory).

Programming tip: To handle and/or modify the files or directories without administrator privileges, you should:

avoid writing to the Windows directory or to the "Program Files" directory,
use the system directory of the application (returned by SysDir with the srAppDataCommun constant, for example).

ProgressBar

To view the progress of file compression, use Event to process the GaugeCompaction message (1174). When this message is received, the _EVE.wParam variable contains the percentage of file compression.

Component: wd270std.dll