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.captureTo("matchString","targetAttribute")
Stream.captureTo("matchString")
Stores the source text string up to, but not including, the designated literal matchString into the designated targetAttribute, and returns the string that follows matchString. Note that matchString is not a regular expression and can only be a literal string.
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'.