AtEnd (StringTokenizer function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (fix "using boolean enumerations" link)
m (fix "using boolean enumerations" link)
Line 3: Line 3:
This method returns a Boolean value that indicates whether
This method returns a Boolean value that indicates whether
the present tokenizing position is immediately after the last token.
the present tokenizing position is immediately after the last token.
The value is <tt>True</tt> if the position at after the last token;
The value is <code>True</code> if the position at after the last token;
otherwise it is <tt>False</tt>.
otherwise it is <tt>False</tt>.


Line 23: Line 23:
<li>The current tokenizing position may be after the last token but
<li>The current tokenizing position may be after the last token but
not necessarily at the end of the token string.
not necessarily at the end of the token string.
In the following code sequence, the return from <var>AtEnd</var> is <tt>True</tt>
In the following code sequence, the return from <var>AtEnd</var> is <code>True</code>
and the position is not at the end of the string:
and the position is not at the end of the string:
<p class="code">%tok:string = 'example      '
<p class="code">%tok:string = 'example      '

Revision as of 20:59, 5 July 2012

Is current tokenizing position at the end of the string? (StringTokenizer class)


This method returns a Boolean value that indicates whether the present tokenizing position is immediately after the last token. The value is True if the position at after the last token; otherwise it is False.

The tokenizing position is given by NextPosition.

Syntax

%boolean = stringTokenizer:AtEnd

Syntax terms

%boolean An enumeration object of type Boolean to contain the returned value of AtEnd. For more information about Boolean enumerations, see "Using Boolean Enumerations".
stringTokenizer A stringTokenizer object.

Usage notes

  • The current tokenizing position may be after the last token but not necessarily at the end of the token string. In the following code sequence, the return from AtEnd is True and the position is not at the end of the string:

    %tok:string = 'example ' %tok:nextPosition = 10 %tok:atEnd

  • NotAtEnd is the reverse of AtEnd: it returns a value of False if the current tokenizing position is at the end of the string.

Examples

The following request selects the string's tokens one after another until the end of the string is detected:

begin %tok is object stringtokenizer %tok = new %tok:string = 'Content-Type: text/plain; charset="US-ASCII"' repeat while not %tok:atEnd printText {~} is {%tok:nextToken} end repeat end

The result is:

%tok:nextToken is Content-Type: %tok:nextToken is text/plain; %tok:nextToken is charset="US-ASCII"

See also