9.250 ZIP_GET_INFO
Þ Note: Built-In Function Rules.
Allows information about a zip file to be retrieved.
Also See
ZIP Built-In Function Note
For use with
|
LANSA for i
|
NO
|
|
Visual LANSA for Windows
|
YES
|
|
Visual LANSA for Linux
|
NO
|
|
Arguments
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Zip file/path name
If no path is specified, the file is assumed to be in the temporary directory.
If file name does not have an extension, .zip will be appended.
|
1
|
256
|
|
|
|
2
|
L
|
Opt
|
Working list containing file names or specifications to include. This argument also applies to files in subdirectories, but not to the subdirectory names.
The default is to include all.
The list cannot contain more than 32,767 entries.
Note: If the list is empty, the default will be used.
|
256
|
256
|
|
|
|
3
|
L
|
Opt
|
Working list containing file names or specifications to exclude. This argument also applies to files in subdirectories, but not to the subdirectory names
The default is to exclude none.
The list cannot contain more than 32,767 entries.
Note: If the list is empty, the default will be used.
This argument is equivalent to zipinfo –x
|
256
|
256
|
|
|
|
4
|
A
|
Opt
|
Positioning filename
Note: This argument would typically only be used to continue loading the list after a previous return code of OV
|
1
|
256
|
|
|
|
Return Values
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Return Code
OK = Zip file able to be read okay
NR = No matching files found
ER = An error was encountered
OV = List returned completely filled, but more files in zip file than can fit in the list
|
2
|
2
|
|
|
|
2
|
N
|
Opt
|
Total size of matching uncompressed files, in bytes
Note: This value is only affected by the list of files to include and exclude. If this BIF is called multiple times for overflow processing, this value will not change.
|
1
|
10
|
0
|
0
|
|
3
|
N
|
Opt
|
Number of matching files
Note: This value is only affected by the list of files to include and exclude. If this BIF is called multiple times for overflow processing, this value will not change.
|
1
|
10
|
0
|
0
|
|
4
|
L
|
Opt
|
Working list to contain file names; will include paths if they exist. List must not contain more than 32,767 entries.
|
256
|
256
|
|
|
|
5
|
A
|
Opt
|
The last file name in the returned list
|
1
|
256
|
|
|
|
6
|
L
|
Opt
|
Working list to contain information about the files returned in the file name list. Entry 1 in the file name list relates directly to Entry 1 in this list. This list must have the same number of entries as the file name list.
Formatted:
Start End Description
1 - 10 Uncompressed size (bytes)
11 - 18 Date YYYYMMDD
19 - 24 Time HHMMSS
|
18
|
24
|
|
|
|
Technical Notes
- When specifying file names or specifications to include or exclude, the forward slash (/) must always be used when specifying a path. For example, x_lansa/x_ppp/mytable.dll
- This BIF can be used to test (zip -t) the validity of a .zip file, without returning any information, if only the first return value is specified.