Programmer Guide/Command Reference/TOKEN: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 17: | Line 17: | ||
:If set, the function sets the return code on failure. Otherwise, it sets the return code to 0, even if the parameters are invalid. | :If set, the function sets the return code on failure. Otherwise, it sets the return code to 0, even if the parameters are invalid. | ||
; | ;<code>/Delimiter=<var>delimiter</var></code> | ||
:Set the delimiter character. The default delimiter is a blank character. | |||
:The default delimiter is a blank. | |||
== Example == | == Example == | ||
Revision as of 15:23, 2 May 2014
var := TOKEN [ /Silent ] [ /D=delimiter ] /- index string1 string2
This command, similar to the WORD command, tokenises a string using blanks, or the specified delimiter.
The command returns the respective token or an empty string if index is not a number or if it is outside the range 0…nTokens-1
When using TOKEN, do not forget to use the /- option before the first argument (and after any other options). Without the /- option, any argument starting with a slash will be mistaken for an option.
- index
- The zero-based index of the token to return (0 ≤ index ≤ nWords-1).
- string1 string2
- A string to tokenise.
/Silent- If set, the function sets the return code on failure. Otherwise, it sets the return code to 0, even if the parameters are invalid.
/Delimiter=delimiter- Set the delimiter character. The default delimiter is a blank character.
Example
#str := set 'to be, or not to be, that is the question' #var := token /D=, /- 1 $#str um The second comma separated value in the string "$#str" is "$#var" // will return ' or not to be'
