PreviousChar (StringTokenizer function)

From m204wiki
Jump to navigation Jump to search

Value of previous character and step back one position (StringTokenizer class)

[Introduced in Sirius Mods 7.8]


This method returns the value of the character that precedes the character that is at the tokenizing position, and it steps the tokenizing position back to the preceding character. The tokenizing position is the value returned by NextPosition.

Syntax

%string = stringTokenizer:PreviousChar

Syntax terms

%string A string variable to receive the returned character value.
stringTokenizer A StringTokenizer object variable.

Usage notes

  • The PeekPreviousChar function also returns the value of the next character, but it does not step back the tokenizing position.

Examples

The following sequence of PrintText statements display, respectively, Example, e, l, p, and p, showing that the tokenizing position moves after PreviousChar completes but not after PeekPreviousChar completes:

%tok = new %tok:string = 'Example of previousChar' PrintText {~} is {%tok:nextToken} PrintText {~} is {%tok:previousChar} PrintText {~} is {%tok:previousChar} PrintText {~} is {%tok:peekPreviousChar} PrintText {~} is {%tok:peekPreviousChar}

See also