PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Search Mode
  • Subscript of files in the archive
  • Formats of archives
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Finds a file in an archive (in CAB, ZIP, RAR, WDZ, 7z, TAR or TGZ (TAR.GZ) format). The search is performed in the stored path of the file.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
New in version 18
Android Widget This function is now available in Android Widget mode.
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
Android Widget This function is now available in Android Widget mode.
WINDEVWEBDEV - Server codeWindows This function now supports the 7z format.
Versions 19 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 19
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server codeWindowsLinuxiPhone/iPadUniversal Windows 10 App This function now supports the TAR and TGZ (TAR.GZ) formats.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server codeWindowsLinuxiPhone/iPadUniversal Windows 10 App This function now supports the TAR and TGZ (TAR.GZ) formats.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
WINDEVWEBDEV - Server codeWindowsLinuxiPhone/iPadUniversal Windows 10 App This function now supports the TAR and TGZ (TAR.GZ) formats.
WINDEVWEBDEV - Server codeJavaAjaxUser code (UMC)
// Create the archive
ResCreate = zipCreate("MyArchive", "C:\Temp\Archive.zip")
IF ResCreate = 0 THEN
        ...
       // Find a file whose stored path contains "Temp"
        ResFileFound = zipFindFile("MyArchive", "Temp", False)
        ...
END
Windows Mobile
// Create the archive
ResCreate = zipCreate("MyArchive", "\Temp\Archive.zip")
IF ResCreate = 0 THEN
        ...
       // Find a file whose stored path contains "Temp"
        ResFileFound = zipFindFile("MyArchive", "Temp", False)
        ...
END
Syntax
<Result> = zipFindFile(<Archive> , <Sought Path> [, <Search Mode> [, <Start>]])
<Result>: Integer
  • Subscript of the file sought in the archive,
  • -1 if an error occurred.
<Archive>: Character string (with quotes) or zipArchive variable
Name of the archive in which the file must be sought.
This name can correspond to:
<Sought Path>: Character string (with quotes)
Full or partial path of the file to find. This parameter can correspond to:
  • a file name,
  • the full path of a file,
  • the path and name of a file,
  • ...
When a path is specified, the directory separator is the back-slash (\), and the root directory should not be specified.
The search is not case sensitive (lowercase/uppercase characters).
<Search Mode>: Optional boolean
  • True (default value) for an exact-match search,
  • False for a generic search. The search is not case sensitive (lowercase/uppercase characters).
Archives in 7z format: This parameter is not available.
<Start>: Optional integer
Subscript of the file from which the search must be performed (1 by default, which means the first file included in the archive).
Archives in 7z format: This parameter is not available.
Remarks

Search Mode

Depending on the selected <Search mode>, the result may differ:
  • If an exact-match search is performed, zipFindFile will find the files whose stored path is strictly identical to <Sought Path>.
    For example: an archive contains "Temp.doc", "Temp1.doc" and "Temp2.doc". An exact-match search for "Temp.doc" will find "Temp.doc".
  • If a generic search is performed, zipFindFile will find all the files whose stored path contains <Sought Path>.
    For example: an archive contains "Temp.doc", "Temp1.doc" and "Temp2.doc". A generic search for the "Temp" string will find three files.
Reminder: The stored path is defined by zipAddFile or zipAddDirectory.

Subscript of files in the archive

When a file is added into an archive, a subscript is automatically assigned to the file. This subscript corresponds to the order in which the files are included in the archive. To select a file found in the archive, you can use:
  • the subscript of the element.
  • the stored path of element.

Formats of archives

  • LinuxiPhone/iPadUniversal Windows 10 App Only the archives in ZIP, TAR and TGZ (TAR.GZ) format are available.
  • AndroidAndroid Widget Windows MobileJava Only the archives in ZIP format are available.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230zip.dll
Windows Mobile wp230zip.dll
Java wd230java.jar
Linux wd230zip.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment