getEnvironmentVariable
getEnvironmentVariable() Function
Note: This function can only be used in a Trusted Macro
This function is useful for situations where the script may wish to interact with the environment outside of MapTool, such as using the exportData() function to write a string to an external file.
Caution:
This function is considered experimental and its implementation and parameters may change.
Usage
<source lang="mtmacro" line> getEnvironmentVariable(varname) </syntaxhighlight>
The value of varname
specifies which environment variable is queried. On most operating systems, environment variables are all uppercase letters, but this is a naming convention and not required. Note that no way exists to query what all of the environment variables are, so the script writer must know which variable they want to retrieve.
Example
<source lang="mtmacro" line> [getEnvironmentVariable("PATH")] [getEnvironmentVariable("TEMP")] [getEnvironmentVariable("USERNAME")]
</syntaxhighlight>