Built-in macros: $path

The $path macro is replaced by the full name of the currently compiled method or inline code member identifying the location where the macro appears.

Content

unit‑name::inline‑code‑name

unit‑name::class‑name.method‑name

Discussion

The path is composed of identifiers separated by :: and . delimiters. The first identifier determines the name of the unit the affected method or inline code is implemented inside. The second identifier identifies the inline code member itself or, in case of a method, the class containing this method. Following is an example of path identifying the method UpdateViewState() implemented within the class Application::Button:

Application::Button.UpdateViewState

The macro $path is used mainly within a string literal to format e.g. a trace debug message:

trace "Error at the $line in method $path";