(PureBasic) Extract Only Newer Files Using UnzipNewer

See more Zip Examples

This example demonstrates how to use the UnzipNewer method to extract only those ZIP entries that are newer than existing files already present on disk.

This is useful for:

• Updating previously extracted ZIP contents
• Avoiding unnecessary overwriting of unchanged files
• Incremental deployment or synchronization scenarios
• Faster extraction when many files are already up-to-date

Suppose the ZIP archive contains:

docs/readme.txt
images/logo.png
data/config.json

And suppose the target extraction directory already contains:

c:/temp/app/docs/readme.txt
c:/temp/app/images/logo.png

If the ZIP version of docs/readme.txt is newer than the existing file on disk, it will be extracted and overwrite the existing file.

If the existing images/logo.png file is already newer or has the same timestamp, it will not be overwritten.

Files that do not yet exist on disk are extracted normally.

The UnzipNewer method returns the number of files extracted, or -1 if the operation fails.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkZip.pb"

Procedure ChilkatExample()

    success.i = 0

    zip.i = CkZip::ckCreate()
    If zip.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Open an existing ZIP archive.
    success = CkZip::ckOpenZip(zip,"qa_data/zips/applicationUpdate.zip")
    If success = 0
        Debug CkZip::ckLastErrorText(zip)
        CkZip::ckDispose(zip)
        ProcedureReturn
    EndIf

    ; ------------------------------------------------------------
    ; Extract only ZIP entries that are newer than the
    ; corresponding files already existing on disk.
    ; 
    ; Existing files that are already up-to-date are skipped.
    ; 
    numFilesUnzipped.i = CkZip::ckUnzipNewer(zip,"c:/temp/app")

    If numFilesUnzipped < 0
        Debug CkZip::ckLastErrorText(zip)
        CkZip::ckDispose(zip)
        ProcedureReturn
    EndIf

    Debug "Number of files extracted = " + Str(numFilesUnzipped)
    Debug ""

    ; ------------------------------------------------------------
    ; Example behavior:
    ; 
    ; ZIP contains:
    ; 
    ;     docs/readme.txt
    ;     images/logo.png
    ;     data/config.json
    ; 
    ; Existing filesystem files:
    ; 
    ;     c:/temp/app/docs/readme.txt
    ;     c:/temp/app/images/logo.png
    ; 
    ; If the ZIP version of docs/readme.txt is newer,
    ; it will overwrite the existing file.
    ; 
    ; If c:/temp/app/images/logo.png is already newer,
    ; it will be skipped.
    ; 
    ; data/config.json will be extracted if it does not
    ; already exist.
    ; 

    CkZip::ckCloseZip(zip)

    Debug "UnzipNewer completed successfully."


    CkZip::ckDispose(zip)


    ProcedureReturn
EndProcedure