Bzip2 Class
Properties Methods Events Configuration Settings Errors
The Bzip2 component implements a bzip2 compressor and decompressor. It is compliant with bzip2 specification.
Class Name
IPWorksZip_Bzip2
Procedural Interface
ipworkszip_bzip2_open(); ipworkszip_bzip2_close($res); ipworkszip_bzip2_register_callback($res, $id, $function); ipworkszip_bzip2_get_last_error($res); ipworkszip_bzip2_get_last_error_code($res); ipworkszip_bzip2_set($res, $id, $index, $value); ipworkszip_bzip2_get($res, $id, $index); ipworkszip_bzip2_do_abort($res); ipworkszip_bzip2_do_append($res); ipworkszip_bzip2_do_compress($res); ipworkszip_bzip2_do_config($res, $configurationstring); ipworkszip_bzip2_do_extract($res); ipworkszip_bzip2_do_extractall($res); ipworkszip_bzip2_do_reset($res); ipworkszip_bzip2_do_scan($res);
Remarks
The bzip2 file format is typically used only to archive a single file. Accordingly, the operation of the class is simpler than that of the other classs.
To compress with the class, set ArchiveFile to the name of the bzip2 file to be created, and FileDecompressedName to the name of the file to be compressed. Finally, invoke Compress. To extract the file, set ArchiveFile to the bzip2 archive and FileDecompressedName to the file where the class should extract. Finally, invoke the Extract or Compress method.
Example (Creating a Bzip2 File)
ZipControl.ArchiveFile =
"c:\test.bz2"
ZipControl.FileDecompressedName =
"c:\test.txt"
ZipControl.Compress()
ZipControl.ArchiveFile =
"c:\test.bz2"
ZipControl.FileDecompressedName =
"c:\test.txt"
ZipControl.Extract()
This class is an implementation based on Julian Seward's bzip2 library (http://www.bzip.org).
Property List
The following is the full list of the properties of the class with short descriptions. Click on the links for further details.
ArchiveFile | The name of the zip, gzip, tar, or jar archive. |
Bzip2Data | (Decompression only) The bzip2 file contents as a byte array. |
ExtractToPath | A base path to decompress to. |
FileDecompressedName | File name to decompress to, or compress from. |
FileInputData | The data of the file to be compressed. |
HasMoreData | Shows whether or not there is more data in the bzip2 archive. |
Method List
The following is the full list of the methods of the class with short descriptions. Click on the links for further details.
Abort | Aborts the current operation. |
Append | Adds specified file to an existing archive. |
Compress | Creates the compressed bzip2 archive. |
Config | Sets or retrieves a configuration setting . |
Extract | Extracts the compressed file from the bzip2 archive. |
ExtractAll | Extracts all files from the compressed archive. |
Reset | Resets the component. |
Scan | Scans the compressed archive. |
Event List
The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.
BeginFile | Fired before a file is processed. |
EndFile | Fired after a file is processed. |
Error | Information about non-fatal errors. |
Overwrite | Fired whenever a file exists and may be overwritten. |
Progress | Fired as progress is made. |
Configuration Settings
The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.
MergeExtractedData | If true, the component will merge concatenated data into one output file when decompressing. |
WriteToProgressEvent | Whether or not to write data to the Progress Event. |
CodePage | The system code page used for Unicode to Multibyte translations. |