Back to Script Function Reference
Add_CLP()
The Add_CLP() function adds text to the emulator's command line arguments. It automatically adds quotes around long filenames if they contain spaces. If you do not wish to have the quotes automatically added, use Add_CLP2().
Syntax
Add_CLP(text)
Arguments
| Argument | Required | Description |
|---|---|---|
| text | Yes | The text to add to the emulator's command line. Any script environment variables found in text will be replaced by their actual values when the script is executed. |
Examples
Add_CLP(%gamefile%,%imageindex%) Add_CLP( -autotype "LOAD")
Note the “ ” (space) at the start of the second example's arguments. This is needed when continuing the command line across multiple Add_CLP() calls, because the exact contents enclosed within the parentheses is directly appended to the command line. If you called both examples above one after the other, without including the space character in the second example, the resulting command line would be:
%gamefile%,%imageindex%-autotype "LOAD"
instead of:
%gamefile%,%imageindex% -autotype "LOAD"
Remarks
You can call this function multiple times, each one adding more text to the emulator's command line. If the script is set to use long filenames, any replaced environment variables that correspond to a filepath or filename will be surrounded by double quotes (“”) only if they contain a space character.