Operator Scope of Action:
Operator First Added:
Operator Last Altered:
Function [other Function type actions]
Item [operators of similar scope]
Data manipulation [other Data manipulation operators]
As at baseline
The .following( ) operator extracts information from one or more paragraphs of a string using a literal quoted string as the match (i.e. no regex support). If matchStr appears in a line, then whatever follows after the matchStr is the result. If matchStr appears in more than one line, the return value is a list of results.
For example, if the text of a note is:
From: Mark To: Clotilde Subject: Mignardise
$MyString = $Text.following("To:");
would return "Clotilde".
$MyString = $Text.following(":");
would return "Mark;Clotilde:Mignardise".
In addition, the .following() operator binds any text that precedes the matchStr string to $0. If the matchStr appears several times, the first prefix is bound to $0, the second to $1, and so forth.
The .following() operator's argument is interpreted as a sequence of characters, not a regular expression. If the flexibility of regular expressions is needed, use .find() instead.
The .following() operator is useful for extracting formal and semi-formal data from free text and simple interchange formats like email and RIS.