TOKEN

From STX Wiki
Jump to navigationJump to search
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 ≤ indexnWords-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
Set the delimiter using the following format:
/Delimiter=delimiter, e.g. #var := token /D=, /- $#index $#wordlist
The default delimiter is a blank.

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'

Navigation menu

Personal tools