Operator Scope of Action:
Operator First Added:
The .following( ) operator extracts information from one or more paragraphs of a string. If the literal string match appears in a line, then whatever follows after the match is the result. If match 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 matched pattern to $0. If the pattern 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.