Procedure DataFileGetPath(datafile, path)

DataFileGetPath

The predefined set AllDataFiles (and its subsets AllCases and AllDataSets), is an integer set. The mapping of these integers onto the cases and datasets in the project is maintained by the data manager, and is not editable. With the procedure DataFileGetPath you can obtain the path in the data manager for any element of the set AllDataFiles (cases or datasets). The path of a datafile consists of a sequence folder names and the name of the datafile itself, separated by backslash characters.

DataFileGetPath(
        datafile,     ! (input) element in the set AllDataFiles
        path          ! (output) scalar string parameter
        )

Arguments

datafile

An element in the set AllDataFiles.

path

A scalar string valued parameter. On return this parameter will contain the path of the datafile.

Return Value

The procedure returns 1 if the given datafile still exists, and 0 otherwise.

Note

  • This function is only applicable if the project option Data_Management_style is set to Single_Data_Manager_file.