关于

The ZipFile class provides means to work with ZIP archives. ZIP files can be created, modified and extracted.

注意: To create ZIP archives with the MAXON API see Archives Manual .

Allocation/Deallocation

ZipFile objects are created with the usual tools, see Entity Creation and Destruction Manual (Classic) .

ZipFile::Alloc() : Allocates a ZipFile .
ZipFile::Free() : Destructs a ZipFile previously allocated with ZipFile::Alloc() .

Opening and Closing

ZipFile::Open() : Opens a ZIP file.
ZipFile::OpenEncrypted() : Opens an AES encrypted ZIP file, see AESFile .
ZipFile::SetSpanning() : Sets the maximum size of the ZIP file. A new file is created with the same name and a consecutive number if it exceeds this size.

注意

Needs to be called immediately after opening a ZIP file for writing.
ZipFile::Close() : Closes the ZIP file.

Filename

ZipFile::CreateLocalFileName() : Creates a local file name.
ZipFile::CreateFilename() : Creates a file name.

Metadata

ZipFile::GetGlobalInfo() : Retrieves the global information ( ZipFileGlobalInfo ).
ZipFile::GetGlobalComment() : Retrieves the global comment.

Compression Level

ZipFile::SetCompressionLevel() : Sets the compression level of the ZIP file.

注意

Must be called before opening and initializing the file.
ZipFile::GetCompressionLevel() : Gets the compression level of the ZIP file.

CRC

ZipFile::GetFileCRC() : Gets a ZIP file CRC.
ZipFile::CalcCRC32() : Calculates the CRC from a buffer.

Extracting an Entire Archive

ZipFile::ExtractToDirectory() : Extracts all contents of the ZIP file to the specified directory.

// This example demonstrates extracting the selected ZIP file to a given folder.

Current File

Internally the ZipFile class has a pointer to the "current" file inside of the archive. The following functions provide means to change the current file pointer to another file or directory.

Similar to "normal" files (e.g. BaseFile ) the current file can be opened for reading:

// Open the file. if (!zf-> OpenCurrentFile ()) return PrintMsgAndCloseZipFile(zf, "Error: Failed to open current file in archive." ); // small custom helper function

// Allocate a buffer to read the file into. maxon::AutoMem<Char> buffer = NewMemClear ( Char , fileSizeUncompressed) iferr_ignore ( "nullptr check next" ); if (buffer == nullptr ) return PrintMsgAndCloseZipFile(zf, "Error: Failed to open allocate buffer." ); // small custom helper function

// Reading in chunks of 4096 (0x1000) bytes, just for demonstration purposes. const Int32 maxChunkSize = 0x1000; Char * bufferCurrentPos = buffer; Char * const bufferEnd = buffer. GetPointer () + fileSizeUncompressed; // Points to the first byte behind the allocated buffer. while (!zf-> EndOfCurrentFile ()) { const Int32 chunkSize = ClampValue (( Int32 )(bufferEnd - bufferCurrentPos), 0, maxChunkSize); if (chunkSize <= 0) break ; const Int32 numBytesRead = zf-> ReadCurrentFile (bufferCurrentPos, chunkSize); if (numBytesRead < 0) break ; bufferCurrentPos += numBytesRead; } if (!zf-> EndOfCurrentFile () || (bufferCurrentPos != bufferEnd)) { return PrintMsgAndCloseZipFile(zf, "Error: Something went wrong, while reading file from archive." ); // small custom helper function } zf-> CloseCurrentFile (); zf-> 关闭 ();

内容表

关于