OS_ReadArgs Input String (changes)
Showing changes from revision #2 to #3:
Added | Removed | Changed
OS SWI Calls
» OS_ReadArgs
» Input String
Input String
Syntax
The input string is expected to be a copy of the command line that started the program as the result of calling OS_GetEnv. Each parameter is separated by spaces, and so to include spaces in a parameter it must be enclosed in quotes.
For example: COPY "source file" destination
"number=times/e,file/k/a,expand/s"COPY -input "source file" -output destination -overwrite
Examples
In this example both -input and -output are keywords followed by a value, whereas -overwrite is a switch.
These Because inputs keywords strings are will identified match: by the preceding “-” character you can not have a value starting with a “-” character, for example:-3+6 . To work around this enclose the value with brackets: "-n (-3+6) 10 –file myfile"
"-times 1+7 –file myfile –expand"
"-file myfile –e"
These Keywords input may strings also will be not referred match: to by their alias, or the first letter of either the keyword or the alias. For example, if the syntax string contains"name=title" then all of the following input strings will match:
"myfile "-name –number fred", 4" "-n fred", "-title fred", "-t fred"
"-number 20 –times 4 –file myfile"
If more than one keyword has the same first letter, then only the first keyword in the syntax string will be matched.
Keywords are case insensitive, so "-FILE" and "-file" are identical.
Keywords may be optional and if they are not specified in the input string then the first unused keyword that is not a switch will be given that value.
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.