User Tools

Site Tools


gemus_script_reference:functions:add_clp2

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

gemus_script_reference:functions:add_clp2 [2020/05/12 11:25] (current)
Jimbo created
Line 1: Line 1:
 +Back to [[.:|Script Function Reference]]
  
 +====== Add_CLP2() ======
 +
 +The Add_CLP2() function adds text to the emulator'​s command line arguments. It does **not** automatically add quotes around long filenames if they contain spaces. If you wish to have the quotes automatically added, use [[.:​add_clp|Add_CLP()]].
 +
 +===== Syntax =====
 +
 +<​code>​Add_CLP2(text)</​code>​
 +
 +===== Arguments =====
 +
 +^ Argument ^ Required ^ Description ^
 +| //text// | Yes | The text to add to the emulator'​s command line. Any [[..:​environment_variables|script environment variables]] found in //text// will be replaced by their actual values when the script is executed. |
 +\\ 
 +
 +===== Examples =====
 +
 +<​code>​
 +Add_CLP2(%gamefile%,​%imageindex%)
 +
 +Add_CLP2( -autotype "​LOAD"​)
 +</​code>​
 +
 +Note the " " (space) at the start of the second example'​s arguments. This is needed when continuing the command line across multiple Add_CLP2() 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:
 +
 +<​code>​%gamefile%,​%imageindex%-autotype "​LOAD"</​code>​
 +instead of:
 +<​code>​%gamefile%,​%imageindex% -autotype "​LOAD"</​code>​
 +
 +===== 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 **NOT** be surrounded by double quotes (""​) if they contain a space character.
 +
 +===== See Also =====
 +
 +  * [[.:​add_clp|Add_CLP()]]
 +  * [[.:​edit_clp|Edit_CLP()]]
 +  * [[.:​clear_clp|Clear_CLP()]]
 +  * [[.:|Script Function Reference]]
gemus_script_reference/functions/add_clp2.txt · Last modified: 2020/05/12 11:25 by Jimbo