Progress Event

Fired as progress is made.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
virtual int FireProgress(TarProgressEventParams *e);

typedef struct {
  const char *Data;
  int lenData;
  const char *Filename;
  int64 BytesProcessed;
  int PercentProcessed;
  int reserved;
} TarProgressEventParams;

Unicode (Windows)
virtual INT FireProgress(TarProgressEventParams *e);

typedef struct {
  LPCSTR Data;
  INT lenData;
  LPCWSTR Filename;
  LONG64 BytesProcessed;
  INT PercentProcessed;
  INT reserved;
} TarProgressEventParams;

- (void)onProgress:(NSData*)data :(NSString*)filename :(long long)bytesProcessed :(int)percentProcessed;

#define EID_TAR_PROGRESS 5

virtual INT IPWORKSZIP_CALL FireProgress(LPSTR &lpData, INT &lenData, LPSTR &lpszFilename, LONG64 &lBytesProcessed, INT &iPercentProcessed);

Remarks

The Progress event is automatically fired as compression or decompression is performed. When WriteToProgressEvent is true, the output data is provided through the Data parameter, allowing for it to be streamed out.

Filename contains the name of the file being written. If no file is being written, Filename will contain an empty string, and the output data will be provided exclusively through this event.

BytesProcessed contains the total number of uncompressed bytes processed. PercentProcessed contains the percent of uncompressed bytes processed, corresponding roughly to the running time of the operation.

For Gzip extraction only, BytesProcessed and PercentProcessed will reflect the number of compressed bytes extracted, as it is generally impossible to predetermine the total uncompressed size.

If WriteToProgressEvent is false, Data will contain null.