Entry | |
---|---|
R0 | Pointer to syntax string |
R1 | Pointer to input string |
R2 | Pointer to output buffer |
R3 | Size of output buffer |
Exit | |
---|---|
R0 | Preserved |
R1 | Preserved |
R2 | Preserved |
R3 | Bytes left in output buffer |
The purpose of this call is to scan the input string, and places values in output buffer according to the syntax string.
It is generally used to extract parameters from the command line following a call to OS_GetEnv and using the value of R0 as the input string. As such this call should be used at the start of a program before the first Wimp_Poll.
This call will return error 490 “Parameters not recognised” if:
This call will return error 491 “Argument repeated” if a parameter is repeated in the input string.
This call will also call OS_EvaluateExpression and OS_GSTrans if the qualifiers “/E” and “/G”, respectively, are specified in the syntax string, and any errors from them will also be returned.
In the event of an error, this call does not give any indication as to which item in the input string has caused the problem.