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