ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Archive functions
  • Search mode
  • Index 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/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
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.
Syntax
<Result> = zipFindFile(<Archive> , <Sought path> [, <Search mode> [, <Start>]])
<Result>: Integer
  • Index of the file sought in the archive,
  • -1 if an error occurred.
<Archive>: Character string or zipArchive variable
Name of the archive in which the file must be sought.
This name can correspond to:
<Sought path>: Character string
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, a backslash (\) is used as separator, and the root directory must 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
Index of the file from which the search must be performed (1 by default, i.e. 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 <Stored 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 with zipAddFile or zipAddDirectory.

Index of files in the archive

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

Formats of archives

  • Universal Windows 10 AppiPhone/iPadIOS WidgetMac Catalyst Only ZIP, TAR and TGZ (TAR.GZ) archives are available.
  • AndroidAndroid Widget Only ZIP archives are available.
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

Last update: 06/12/2023

Send a report | Local help