s = filename(dictionary_name ‖ file_handler ‖ pff_name);
function returns the fully qualified name of a file. If supplying a dictionary_name
, the function returns the name of the data file associated with a data dictionary. If providing a file_handler
(declared in a file
statement), the function returns the name of the text file associated with the file handler.
If providing a pff_name
(declared in a pff
statement), the function returns the name of an existing PFF file, or the name of a temporarily created PFF file. If a PFF file was loaded (via pff.load
) and not modified, the name of that PFF file is returned. If the PFF has been modified and not saved, then calling filename
will save the PFF to a temporary file and the name of that file is returned.
The function can also take paradata
as its argument, in which case it returns the file name of the currently open paradata log.
The function returns a string containing the folder and file name.