Identifies and retrieves the different elements of the command line passed as a parameter to the current program.
// The executable is called by the following command line:
// project.exe param1 /opt1=param2 "param31 param32" -opt2="param41 param42"
CommandLine() // Returns the entire command line
CommandLine("") // ERROR: CommandLine() and CommandLine("") are not equivalent
CommandLine(1) // Returns 'param1'
CommandLine(2) // Returns '/opt1 = param2'
CommandLine(3) // Returns 'param31 param32'
CommandLine(4) // Returns '-opt2 = "param41 param42"'
CommandLine(5) // Returns ' '
CommandLine("opt1") // Returns 'param2'
CommandLine("opt2") // Returns 'param41 param42'
CommandLine("opt3") // Returns ' '
CommandLine("opt3", "Empty") // Returns 'Empty'
Syntax
<Result>: Character string
Command line passed to the executable (without the name of the executable itself).
Retrieving the value of Nth parameter in the command line Hide the details
<Result> = CommandLine(<Option index>)
<Result>: Character string
Parameter corresponding to the requested index.
<Option index>: Integer
Index of the option to be retrieved.
Remark: The space character corresponds to the separator.
Retrieving the value of a specific parameter in the command line Hide the details
<Result> = CommandLine(<Option name> , <Default value>)
<Result>: Character string
Value corresponding to the requested parameter.
<Option name>: Character string
Name of the option to be retrieved. The following syntaxes are accepted:- /<name> = value
- -<name> = value
The space character corresponds to the separator. To use a space in the value of a named parameter, the parameter must be enclosed in quotes ("<Parameter with space>").
Example: project.exe param1 /opt1="param2 with spaces".
<Default value>: Character string
Default value returned if the option is not found or does not exist.
By default, the returned value by is an empty string (""). Example:
CommandLine("select", "False")
Commands:
- program.exe -> CommandLine returns "False".
- program.exe /select -> CommandLine returns "False".
- program.exe /select=abc -> CommandLine returns "abc".
Remarks
- In test mode, you can specify the command line in the editor (on the "Project" tab, in the "Test mode" group, expand "Test mode" and select "Configure test mode").
- Unlike CommandLine, dbgStandardOutput allows the executable to return a value to the application that started it (write operation in STDOUT).
Business / UI classification: Neutral code