file-info()
This function returns a semicolon-separated list of properties of file or directory a.
If the file or directory does not exist, empty values are returned.
The optional parameter b controls whether only a specific property is to be output. A value in b that is not in the following table will cause the function to terminate with an error. Only one value can be specified.
Short form |
Value |
Meaning |
h |
header |
Instead of the properties, a header list is returned. |
p |
parent |
Returns the directory the file or directory resides in. The path will be returned as absolute path in canonical form using (/) as separator. |
n |
name |
Returns the file or directory name without path. |
t |
type |
Returns d for a directory, f for a file and ? for a device, named pipe, etc. (in Unix systems). |
s |
size |
Returns the size of the file in bytes or 0 for a directory. |
m |
modified |
Returns the time of the last modification in ISO format. |
r |
read |
Returns true if the file/directory is readable. |
w |
write |
Returns true if the file/directory is writeable. |
Parameters
Parameter |
Description |
a |
Relative (to the installation directory of the Integration Server) or absolute path of the file/directory. |
b |
(optional) Reduction to one specific property (see table above). Note: Use the three dots to select a value. |
Examples
Parameter a |
Parameter b |
Result |
./temp/existingfile |
|
/temp;existingfile;f;5000;2011-04-23 12:34:56.0;true;false |
./temp/nonexistingfile |
|
;;;;;; |
./temp/existingfile |
header |
parent;name;type;size;modified;read;write |
./temp/existingfile |
s |
5000 |
./temp/existingfile |
size |
5000 |