StartOfString (StringTokenizer function)

From m204wiki
Revision as of 20:48, 15 November 2012 by JAL (talk | contribs) (→‎Examples)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Substring that precedes first character of current token (StringTokenizer class)


This method returns the substring of the tokenizer string that precedes the first character of the current token.

Syntax

%string = stringTokenizer:StartOfString

Syntax terms

%string A string variable to receive the characters that precede the current position.
stringTokenizer A StringTokenizer object expression.

Usage notes

  • StartOfString does not advance the position.
  • The substring returned by StartOfString ends at (but does not include) the first character of the current token, the position of which is the value of CurrentTokenPosition. The value of the current token is returned by CurrentToken.
  • StartOfString returns a null string if it is issued before a token is found or if the value of NextPosition is 1.
  • The RestOfString function returns the substring of the tokenizer string that follows the present tokenizing position.

Examples

The following request fragment shows that consecutive StartOfString statements do not advance the position:

%tok:string = 'A StartOfString example' %tok:findToken:('example') PrintText {%tok:startOfString} printText {%tok:startOfString}\\

The result is:

A StartOfString A StartOfString \\

See also