NextToken (StringTokenizer function) - Revision history

JAL: /* Examples */

2012-11-15T20:32:24Z

Examples

← Older revision		Revision as of 20:32, 15 November 2012
Line 56:		Line 56:
	%tok = new		%tok = new
	%tok:string = 'example of nextToken'		%tok:string = 'example of nextToken'
	~~printText~~ {%tok:nextToken}		[[Targeted Text statements#AuditText, PrintText, and TraceText\|PrintText]] {%tok:nextToken}
	printText {%tok:nextToken}		printText {%tok:nextToken}
	printText {%tok:nextToken}		printText {%tok:nextToken}
Line 80:		Line 80:
	</p>		</p>
	</ol>		</ol>

	==See also==		==See also==
	{{Template:StringTokenizer:NextToken footer}}		{{Template:StringTokenizer:NextToken footer}}

Dme at 17:02, 8 February 2012

2012-02-08T17:02:43Z

← Older revision		Revision as of 17:02, 8 February 2012
Line 4:		Line 4:
	the next token forward in the current tokenizer string.		the next token forward in the current tokenizer string.
	The next token parsing begins from the tokenizing position,		The next token parsing begins from the tokenizing position,
	which is the value returned by [[NextPosition (StringTokenizer property)\|NextPosition]].		which is the value returned by <var>[[NextPosition (StringTokenizer property)\|NextPosition]]</var>.

	When the next token is determined,		When the next token is determined,
Line 11:		Line 11:

	The delimiters that are involved in determining the tokens		The delimiters that are involved in determining the tokens
	are set initially by the [[New (StringTokenizer constructor)\|New]] method		are set initially by the <var>[[New (StringTokenizer constructor)\|New]]</var> method
	that instantiates the <var>StringTokenizer</var> object.		that instantiates the <var>StringTokenizer</var> object.
	The delimiters can be modified by the [[Spaces (StringTokenizer property)\|Spaces]],		The delimiters can be modified by the <var>[[Spaces (StringTokenizer property)\|Spaces]]</var>,
	[[Quotes (StringTokenizer property)\|Quotes]], and [[TokenChars (StringTokenizer property)\|TokenChars]] properties.		<var>[[Quotes (StringTokenizer property)\|Quotes]]</var>, and <var>[[TokenChars (StringTokenizer property)\|TokenChars]]</var> properties.
	==Syntax==		==Syntax==
	{{Template:StringTokenizer:NextToken syntax}}		{{Template:StringTokenizer:NextToken syntax}}
Line 26:		Line 26:
	<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of <var class="term">number</var> must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. See the [[#skipEx\|example]] below.		<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of <var class="term">number</var> must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. See the [[#skipEx\|example]] below.

	The <var>Skip</var> ~~parameter~~ is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>		The <var>Skip</var> argument is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>

	</table>		</table>
Line 32:		Line 32:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <tt>True</tt>,		<li>If the value of <var>[[AtEnd (StringTokenizer function)\|AtEnd]]</var> is <code>True</code>,
	issuing <var>NextToken</var> is invalid and cancels the request.		issuing <var>NextToken</var> is invalid and cancels the request.
	<li>For a new <var>StringTokenizer</var> instance, issuing <var>NextToken</var>,		<li>For a new <var>StringTokenizer</var> instance, issuing <var>NextToken</var>,
	[[FindToken (StringTokenizer function)\|FindToken]], or [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]] is		<var>[[FindToken (StringTokenizer function)\|FindToken]]</var>, or <var>[[SkipTokens (StringTokenizer subroutine)\|SkipTokens]]</var> is
	required before [[CurrentToken (StringTokenizer function)\|CurrentToken]] may be issued without error.		required before <var>[[CurrentToken (StringTokenizer function)\|CurrentToken]]</var> may be issued without error.
	<li>~~The NextPosition~~ [[NextPosition (StringTokenizer property)\|NextPosition]] returns the position of		<li><var>[[NextPosition (StringTokenizer property)\|NextPosition]]</var> returns the position of
	the character after the <var>NextToken</var> value.		the character after the <var>NextToken</var> value.
	Conversely, the determination of the <var>NextToken</var> value always starts at the		Conversely, the determination of the <var>NextToken</var> value always starts at the
	position given by NextPosition.		position given by <var>NextPosition</var>.
	If you reset NextPosition, the value returned by your next <var>NextToken</var> call		If you reset <var>NextPosition</var>, the value returned by your next <var>NextToken</var> call
	will be based on the new NextPosition value.		will be based on the new <var>NextPosition</var> value.
	<li>The FindToken and [[PeekToken (StringTokenizer function)\|PeekToken]]		<li>The <var>FindToken</var> and <var>[[PeekToken (StringTokenizer function)\|PeekToken]]</var>
	functions also return the next token.		functions also return the next token.
	Like <var>NextToken</var>, FindToken		Like <var>NextToken</var>, <var>FindToken</var>
	advances the tokenizing position to the position following that token.		advances the tokenizing position to the position following that token.
	PeekToken, however, does not advance the tokenizing position.		<var>PeekToken</var>, however, does not advance the tokenizing position.
	</ul>		</ul>
	==Examples==		==Examples==
	<ol>		<ol>
	<li>In the following request fragment, the printText statements display,		<li>In the following request fragment, the printText statements display,
	respectively, <tt>example</tt>, <tt>of</tt>, and <tt>nextToken</tt>.		respectively, <code>example</code>, <code>of</code>, and <code>nextToken</code>.
	<p class="code">%tok is object stringTokenizer		<p class="code">%tok is object stringTokenizer
	%tok = new		%tok = new
Line 62:		Line 62:
	<br>		<br>
	<div id="skipEx"></div>		<div id="skipEx"></div>
	<li>The following request fragment shows the effect of the Skip ~~parameter~~:		<li>The following request fragment shows the effect of the <var>Skip</var> argument:
	<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'		<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'
	repeat while %tok:notAtEnd		repeat while %tok:notAtEnd

Dme at 16:53, 8 February 2012

2012-02-08T16:53:07Z

← Older revision		Revision as of 16:53, 8 February 2012
Line 24:		Line 24:
	<td>A <var>StringTokenizer</var> object expression. </td></tr>		<td>A <var>StringTokenizer</var> object expression. </td></tr>
	<tr><th><var>Skip</var></th>		<tr><th><var>Skip</var></th>
	<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of <var class="term">number</var> must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. ~~For an example, see item~~ [[??]] ~~refid=skipxmp.~~.		<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of <var class="term">number</var> must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. See the [[#skipEx\|example]] below.

	The <var>Skip</var> parameter is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>		The <var>Skip</var> parameter is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>
Line 61:		Line 61:
	</p>		</p>
	<br>		<br>
			<div id="skipEx"></div>
	<li>The following request fragment shows the effect of the Skip parameter:		<li>The following request fragment shows the effect of the Skip parameter:
	<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'		<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'

Dme: /* Syntax terms */

2012-02-08T16:48:10Z

Syntax terms

← Older revision		Revision as of 16:48, 8 February 2012
Line 24:		Line 24:
	<td>A <var>StringTokenizer</var> object expression. </td></tr>		<td>A <var>StringTokenizer</var> object expression. </td></tr>
	<tr><th><var>Skip</var></th>		<tr><th><var>Skip</var></th>
	<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''number'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..		<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of <var class="term">number</var> must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..

	The <var>Skip</var> parameter is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>		The <var>Skip</var> parameter is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>

JALWiccan: 1 revision

2011-05-24T22:31:14Z

1 revision

New page

{{Template:StringTokenizer:NextToken subtitle}}

This method returns the string value of
the next token forward in the current tokenizer string.
The next token parsing begins from the tokenizing position,
which is the value returned by [[NextPosition (StringTokenizer property)|NextPosition]].

When the next token is determined,
<var>NextToken</var> advances the tokenizing position
to the position following that token, then returns the token value.

The delimiters that are involved in determining the tokens
are set initially by the [[New (StringTokenizer constructor)|New]] method
that instantiates the <var>StringTokenizer</var> object.
The delimiters can be modified by the [[Spaces (StringTokenizer property)|Spaces]],
[[Quotes (StringTokenizer property)|Quotes]], and [[TokenChars (StringTokenizer property)|TokenChars]] properties.
==Syntax==
{{Template:StringTokenizer:NextToken syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string variable to receive the value of the current token. </td></tr>
<tr><th>stringTokenizer</th>
<td>A <var>StringTokenizer</var> object expression. </td></tr>
<tr><th><var>Skip</var></th>
<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''number'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..

The <var>Skip</var> parameter is available as of version 7.7 of the <var class="product">Sirius Mods</var>.</td></tr>

</table>

==Usage notes==
<ul>
<li>If the value of [[AtEnd (StringTokenizer function)|AtEnd]] is <tt>True</tt>,
issuing <var>NextToken</var> is invalid and cancels the request.
<li>For a new <var>StringTokenizer</var> instance, issuing <var>NextToken</var>,
[[FindToken (StringTokenizer function)|FindToken]], or [[SkipTokens (StringTokenizer subroutine)|SkipTokens]] is
required before [[CurrentToken (StringTokenizer function)|CurrentToken]] may be issued without error.
<li>The NextPosition [[NextPosition (StringTokenizer property)|NextPosition]] returns the position of
the character after the <var>NextToken</var> value.
Conversely, the determination of the <var>NextToken</var> value always starts at the
position given by NextPosition.
If you reset NextPosition, the value returned by your next <var>NextToken</var> call
will be based on the new NextPosition value.
<li>The FindToken and [[PeekToken (StringTokenizer function)|PeekToken]]
functions also return the next token.
Like <var>NextToken</var>, FindToken
advances the tokenizing position to the position following that token.
PeekToken, however, does not advance the tokenizing position.
</ul>
==Examples==
<ol>
<li>In the following request fragment, the printText statements display,
respectively, <tt>example</tt>, <tt>of</tt>, and <tt>nextToken</tt>.
<p class="code">%tok is object stringTokenizer
%tok = new
%tok:string = 'example of nextToken'
printText {%tok:nextToken}
printText {%tok:nextToken}
printText {%tok:nextToken}
</p>
<br>
<li>The following request fragment shows the effect of the Skip parameter:
<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'
repeat while %tok:notAtEnd
printtext {~} = '{%tok:nextToken(skip=1)}'
end repeat
</p>

The result is:
<p class="output">%tok:nextToken(skip=1) = '0'
%tok:nextToken(skip=1) = '1'
%tok:nextToken(skip=1) = '2'
%tok:nextToken(skip=1) = '3'
%tok:nextToken(skip=1) = '4'
%tok:nextToken(skip=1) = '5'
%tok:nextToken(skip=1) = '6'
%tok:nextToken(skip=1) = '7'
</p>
</ol>
==See also==
{{Template:StringTokenizer:NextToken footer}}

JAL2: /* Syntax terms */

2011-04-13T02:00:34Z

Syntax terms

← Older revision		Revision as of 02:00, 13 April 2011
Line 23:		Line 23:
	<tr><th>%tok</th>		<tr><th>%tok</th>
	<td>A <var>StringTokenizer</var> object expression. </td></tr>		<td>A <var>StringTokenizer</var> object expression. </td></tr>
	<tr><th><var>Skip~~= num~~</var></th>		<tr><th><var>Skip</var></th>
	<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''num'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..		<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''num'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..

JALWiccan: 1 revision

2011-04-13T01:54:51Z

1 revision

New page

{{Template:StringTokenizer:NextToken subtitle}}

This method returns the string value of
the next token forward in the current tokenizer string.
The next token parsing begins from the tokenizing position,
which is the value returned by [[NextPosition (StringTokenizer property)|NextPosition]].

When the next token is determined,
<var>NextToken</var> advances the tokenizing position
to the position following that token, then returns the token value.

The delimiters that are involved in determining the tokens
are set initially by the [[New (StringTokenizer constructor)|New]] method
that instantiates the <var>StringTokenizer</var> object.
The delimiters can be modified by the [[Spaces (StringTokenizer property)|Spaces]],
[[Quotes (StringTokenizer property)|Quotes]], and [[TokenChars (StringTokenizer property)|TokenChars]] properties.
==Syntax==
{{Template:StringTokenizer:NextToken syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string variable to receive the value of the current token. </td></tr>
<tr><th>%tok</th>
<td>A <var>StringTokenizer</var> object expression. </td></tr>
<tr><th><var>Skip= num</var></th>
<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''num'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..

The Skip parameter is available as of version 7.7 of the ''Sirius Mods''.</td></tr>

</table>

==Usage notes==
<ul>
<li>If the value of [[AtEnd (StringTokenizer function)|AtEnd]] is <tt>True</tt>,
issuing <var>NextToken</var> is invalid and cancels the request.
<li>For a new <var>StringTokenizer</var> instance, issuing <var>NextToken</var>,
[[FindToken (StringTokenizer function)|FindToken]], or [[SkipTokens (StringTokenizer subroutine)|SkipTokens]] is
required before [[CurrentToken (StringTokenizer function)|CurrentToken]] may be issued without error.
<li>The NextPosition [[NextPosition (StringTokenizer property)|NextPosition]] returns the position of
the character after the <var>NextToken</var> value.
Conversely, the determination of the <var>NextToken</var> value always starts at the
position given by NextPosition.
If you reset NextPosition, the value returned by your next <var>NextToken</var> call
will be based on the new NextPosition value.
<li>The FindToken and [[PeekToken (StringTokenizer function)|PeekToken]]
functions also return the next token.
Like <var>NextToken</var>, FindToken
advances the tokenizing position to the position following that token.
PeekToken, however, does not advance the tokenizing position.
</ul>
==Examples==
<ol>
<li>In the following request fragment, the printText statements display,
respectively, <tt>example</tt>, <tt>of</tt>, and <tt>nextToken</tt>.
<p class="code">%tok is object stringTokenizer
%tok = new
%tok:string = 'example of nextToken'
printText {%tok:nextToken}
printText {%tok:nextToken}
printText {%tok:nextToken}
</p>
<br>
<li>The following request fragment shows the effect of the Skip parameter:
<p class="code">%tok:string = ' * 0 * 1 * 2 * 3 * 4 * 5 * 6 * 7'
repeat while %tok:notAtEnd
printtext {~} = '{%tok:nextToken(skip=1)}'
end repeat
</p>

The result is:
<p class="output">%tok:nextToken(skip=1) = '0'
%tok:nextToken(skip=1) = '1'
%tok:nextToken(skip=1) = '2'
%tok:nextToken(skip=1) = '3'
%tok:nextToken(skip=1) = '4'
%tok:nextToken(skip=1) = '5'
%tok:nextToken(skip=1) = '6'
%tok:nextToken(skip=1) = '7'
</p>
</ol>
==See also==
{{Template:StringTokenizer:NextToken footer}}

Wiccan: 1 revision

2011-02-08T18:16:12Z

1 revision

← Older revision	Revision as of 18:16, 8 February 2011
(No difference)

Wiccan: 1 revision

2011-02-08T18:16:11Z

1 revision

← Older revision		Revision as of 18:16, 8 February 2011
Line 25:		Line 25:
	<tr><th>Skip= num</th>		<tr><th>Skip= num</th>
	<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''num'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..		<td>This name required numeric argument specifies a number of tokens to skip before returning the next token. The value of ''num'' must be greater than 0, and it must be be less than the number of tokens remaining in the tokenizer string. For an example, see item [[??]] refid=skipxmp..
	~~<p class="code">~~The Skip parameter is available as of version 7.7 of the ''Sirius Mods''.</td></tr>
	~~</p>~~		The Skip parameter is available as of version 7.7 of the ''Sirius Mods''.</td></tr>

	</table>		</table>
	==Usage notes==		==Usage notes==

Wiccan: 1 revision

2011-02-06T21:48:04Z

1 revision

← Older revision	Revision as of 21:48, 6 February 2011
(No difference)