Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator First Added:
Operator Altered:
Function [other Function type actions]
Item [operators of similar scope]
Stream parsing [other Stream parsing operators]
9.1.0
Stream.captureToken("targetAttribute")
Stream.captureToken
Captures a sequence of non-whitespace characters ('tokens'), the matched token string is passed to targetAttribute. The stream is not advanced and any chained parsing continues from the same point. Punctuation (notably @) is part of a token but *not* part of a word.
If the targetAttribute is omitted the Stream is advanced to the end so processing ceases.
The attribute given for targetAttribute can be a quoted literal string, e.g. ("Text") for $Text. Or it can be an unquoted variable/loopVariable, e.g. (vString) for a variable 'vString'.