AtEnd (StringTokenizer function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (fix "using boolean enumerations" link)
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:StringTokenizer:AtEnd subtitle}}
{{Template:StringTokenizer:AtEnd subtitle}}


This method returns a Boolean value that indicates whether
This method returns a <var>[[Enumerations#Using_Boolean_enumerations|Boolean]]</var> value that is <var>True</var> if
the present tokenizing position is immediately after the last token.
no tokens remain starting from <var>[[NextPosition (StringTokenizer property)|NextPosition]]</var>.
The value is <tt>True</tt> if the position at after the last token;
otherwise it is <tt>False</tt>.


The tokenizing position is given by [[NextPosition (StringTokenizer property)|NextPosition]].
==Syntax==
==Syntax==
{{Template:StringTokenizer:AtEnd syntax}}
{{Template:StringTokenizer:AtEnd syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%boolean</th>
<tr><th>%boolean</th>
<td>An enumeration object of type <var>Boolean</var> to contain the returned value of <var>AtEnd</var>.
<td>An enumeration object of type <var>Boolean</var> to contain the returned value of <var>AtEnd</var>. The result is <code>true</code> if no tokens remain, starting from <var>NextPosition</var>, and <code>false</code> if any tokens remain.


For more information about <var>Boolean</var> enumerations, see [[Enumerations#Using_Boolean_enumerations|"Using Boolean Enumerations"]]. </td></tr>
<tr><th>stringTokenizer</th>
<tr><th>stringTokenizer</th>
<td>A <var>stringTokenizer</var> object.</td></tr>
<td>A <var>stringTokenizer</var> object.</td></tr>
Line 21: Line 18:
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The current tokenizing position may be after the last token but
<li>It is illegal to scan for a token past the <var>[[CurrentToken (StringTokenizer function)|CurrentToken]]</var> if <var>AtEnd</var> is <code>true</code>.
not necessarily at the end of the token string.
 
In the following code sequence, the return from <var>AtEnd</var> is <tt>True</tt>
<li>For <var>[[Spaces (StringTokenizer property)|Spaces]]</var> tokenization, a token remains if there are any non-<var>Spaces</var> characters remaining at or
after <var>NextPosition</var>.
<li>For <var>[[Separators (StringTokenizer property)|Separators]]</var> tokenization, a token remains if either:
<ul>
<li><var>NextPosition</var> is less than or equal to the length of the <var>String</var>.
<li>Either a token has not been located in the <var>String</var>, or
the last method which located a token found a separator at the end of the <var>String</var>.
</ul>
 
<li><var>NextPosition</var> may be after the last token but not necessarily at the end of the token string.
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 = 'example   ':stringTokenizer
%tok:nextPosition = 10
%tok:nextPosition = 8
%tok:atEnd
printText {~=%tok:atEnd}
</p>
</p>
<li>[[NotAtEnd (StringTokenizer function)|NotAtEnd]] is the reverse of <var>AtEnd</var>:
 
it returns a value of <tt>False</tt>
<li><var>[[NotAtEnd (StringTokenizer function)|NotAtEnd]]</var> is the reverse of <var>AtEnd</var>:
if the current tokenizing position is at the end of the string.
it returns <code>true</code> if any tokens remain starting with <var>NextToken</var>.
</ul>
</ul>
==Examples==
==Examples==
The following request selects the string's tokens one after another until
The following request selects the string's tokens one after another until
the end of the string is detected:
the end of the string is detected:

Latest revision as of 20:09, 14 October 2014

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


This method returns a Boolean value that is True if no tokens remain starting from NextPosition.

Syntax

%boolean = stringTokenizer:AtEnd

Syntax terms

%boolean An enumeration object of type Boolean to contain the returned value of AtEnd. The result is true if no tokens remain, starting from NextPosition, and false if any tokens remain.
stringTokenizer A stringTokenizer object.

Usage notes

  • It is illegal to scan for a token past the CurrentToken if AtEnd is true.
  • For Spaces tokenization, a token remains if there are any non-Spaces characters remaining at or after NextPosition.
  • For Separators tokenization, a token remains if either:
    • NextPosition is less than or equal to the length of the String.
    • Either a token has not been located in the String, or the last method which located a token found a separator at the end of the String.
  • NextPosition 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 = 'example ':stringTokenizer %tok:nextPosition = 8 printText {~=%tok:atEnd}

  • NotAtEnd is the reverse of AtEnd: it returns true if any tokens remain starting with NextToken.

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