FILENAME()

 

Syntax:

       Then: aa = FILENAME(handle)

 

Return value
The filename of the specified handle.

Version Ref:  5.0

 

Description:

Returns the filename of the specified handle.

 

The handle must be a value returned from OPEN() or CREATE().Invalid handles return null.

 

Example:

handle = CREATE("/tmp/tempfile");

...

name = FILENAME(handle)

 

NOTE:

This is useful in generic CALL routines where the filename isn't known. In a text file, it is possible that the value returned by FILESIZE() is not the same number of bytes that can be read from the file.