CAPL Script

GetAbsFilePath

Note This function is not available in case of adistributed environment.

Syntax

long getAbsFilePath(char relPath[], char absPath[], long absPathLen)

Function

Gets the absolute path of a file. As parameter the file should be defined with the relative path to the current configuration.

Parameters

relPath A path (with or without a file name) defined relative to the current configuration. If this parameter is empty, then the full path of the current configuration will simply be returned.

absPath

Buffer to which the full path name should be copied.

absPathLen

Size of the buffer [in bytes] for the full path name.

Return Values

On success this function returns length of the full path name, otherwise -1.

on key 'x'{char absPath[256];getAbsFilePath("Nodes\\Test.can", absPath, 256);write ("absPath: %s ", absPath);}