PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Use conditions
  • Error codes
  • Closing the archive
  • Number of parts
  • Actions that can be performed on a multi-part archive
  • The multi-part archive is found on diskettes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Merges the different sub-archives found in a multi-part archive to create a single-part archive.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 18 and later
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
New in version 18
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
Versions 26 and later
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
New in version 26
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
Android Widget This function is now available in Android widget mode.
Android This function is now available for Android applications.
WINDEVWEBDEV - Server codeReports and QueriesUser code (UMC)Ajax
MyArchive is zipArchive
// Open a multi-part archive
ResOpenArchive = zipOpen(MyArchive, "C:\MyArchives\Archive.zip")
IF ResOpenArchive = 0 THEN
...
// Merge the sub-archives found in a multi-part archive
ResMerge = zipMerge(MyArchive,...
 "C:\MyArchives\SingleArchive.WDZ")
...
END
Syntax
<Result> = zipMerge(<Archive> , <Archive destination> [, <Progress bar management>])
<Result>: Integer
  • 0 if the sub-archives have been merged,
  • an error code (value greater than 0) otherwise. For more details on these error codes, see the Remarks.
<Archive>: Character string or zipArchive variable
Name of the archive to be used.
This name can correspond to:
  • the name of an archive, defined by zipOpen or zipCreate.
  • Versions 15 and later
    WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget iPhone/iPadIOS WidgetMac CatalystAjax the name of a variable of type zipArchive.
    New in version 15
    WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget iPhone/iPadIOS WidgetMac CatalystAjax the name of a variable of type zipArchive.
    WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget iPhone/iPadIOS WidgetMac CatalystAjax the name of a variable of type zipArchive.
    Versions 26 and later
    AndroidAndroid Widget iPhone/iPadIOS WidgetMac Catalyst zipArchive variables are now available.
    New in version 26
    AndroidAndroid Widget iPhone/iPadIOS WidgetMac Catalyst zipArchive variables are now available.
    AndroidAndroid Widget iPhone/iPadIOS WidgetMac Catalyst zipArchive variables are now available.
<Archive destination>: Character string
Physical path of new single-part archive (up to 260 characters). This path must contain the name of single-part archive to create. If the extension (.WDZ or .ZIP) is not specified, the extension corresponds to the initial extension. You have the ability to specify the same path and name as the split archive: the split archive will be overwritten by the merged archive.
<Progress bar management>: Optional character string
Versions 21 and later
WINDEVAndroidiPhone/iPadMac Catalyst Name of the Progress Bar control in a window. The progress bar will display the progress of the grouping.
New in version 21
WINDEVAndroidiPhone/iPadMac Catalyst Name of the Progress Bar control in a window. The progress bar will display the progress of the grouping.
WINDEVAndroidiPhone/iPadMac Catalyst Name of the Progress Bar control in a window. The progress bar will display the progress of the grouping.
Remarks

Use conditions

Remark: The merge operation can be performed if:
  • The archive exists (archives are created using zipCreate).
  • The archive is a multi-part archive.
  • The archive is not in "CAB" format, in "RAR" format or in "TAR" or TARGZ" format.
Reminder:
  • LinuxiPhone/iPadIOS WidgetMac Catalyst Only ZIP, TAR and TGZ (TAR.GZ) archives are available.
  • AndroidAndroid Widget Only ZIP archives are available.

Error codes

The following error codes are returned:
  • 1: The path passed as parameter does not exist.
  • 2: Access denied: the user has no sufficient rights.
  • 3: The archive is corrupted.
  • 6: The sub-archives are not arranged in order.
The message corresponding to the error code is returned by zipMsgError.

Closing the archive

Once zipMerge has been used on an archive, this archive is not closed. You must use:
  • zipClose to close the multi-part archive.
  • zipOpen to open the new single-part archive.

Number of parts

zipNbPart is used to determine the number of sub-archives in a multi-part archive.

Actions that can be performed on a multi-part archive

Some archiving functions can only be used with single-part archives (add and delete files, create a self-extracting executable, etc.). To perform these operations, simply merge the sub-archives (zipMerge) to get a single-part archive.
From a multi-part archive, you can only:
WINDEVWEBDEV - Server codeReports and QueriesUser code (UMC)Ajax

The multi-part archive is found on diskettes

If the different sub-archives are found on diskettes, the next diskette will be automatically requested via a dialog box when the sub-archives are merged. An error will occur if the merge operation is canceled by the user (the multi-part archive is not found).
Business / UI classification: Business Logic
Component: wd270zip.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment