NextChar (StringTokenizer function) - Revision history

JAL at 19:57, 15 November 2012

2012-11-15T19:57:48Z

← Older revision		Revision as of 19:57, 15 November 2012
Line 19:		Line 19:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the value of <var>[[AtEnd (StringTokenizer function)\|AtEnd]]</var> is <code>True</code>,		<li>If the value of <var>[[AtEnd (StringTokenizer function)\|AtEnd]]</var> is <code>True</code>, issuing <var>NextChar</var> is invalid and cancels the request.
	issuing <var>NextChar</var> is invalid and cancels the request.
	<li>Once <var>NextChar</var> executes, the number of the resulting position		<li>Once <var>NextChar</var> executes, the number of the resulting position
	can be returned by <var>NextPosition</var>.		can be returned by <var>NextPosition</var>.

	<li>The <var>[[PeekChar (StringTokenizer function)\|PeekChar]]</var> function also returns the value of the		<li>The <var>[[PeekChar (StringTokenizer function)\|PeekChar]]</var> function also returns the value of the
	next character, but it does not advance the tokenizing position.		next character, but it does not advance the tokenizing position.
	</ul>		</ul>

	=Examples==		=Examples==
	The following sequence of <var>Print</var> statements display,		The following sequence of <var>Print</var> statements display,

JAL2 at 23:16, 5 July 2012

2012-07-05T23:16:30Z

← Older revision		Revision as of 23:16, 5 July 2012
Line 3:		Line 3:
	This method returns the value of the character that is at the tokenizing position,		This method returns the value of the character that is at the tokenizing position,
	and it advances the tokenizing position past that character to the next character.		and it advances the tokenizing position past that character to the next character.
	The tokenizing position is the value returned by [[NextPosition (StringTokenizer property)\|NextPosition]].		The tokenizing position is the value returned by <var>[[NextPosition (StringTokenizer property)\|NextPosition]]</var>.

	==Syntax==		==Syntax==
	{{Template:StringTokenizer:NextChar syntax}}		{{Template:StringTokenizer:NextChar syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%string</th>		<tr><th>%string</th>
	<td>A string variable to receive the returned character value. </td></tr>		<td>A string variable to receive the returned character value. </td></tr>

	<tr><th>stringTokenizer</th>		<tr><th>stringTokenizer</th>
	<td>A <var>StringTokenizer</var> object ~~expression~~.</td></tr>		<td>A <var>StringTokenizer</var> object.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <code>True</code>,		<li>If the value of <var>[[AtEnd (StringTokenizer function)\|AtEnd]]</var> is <code>True</code>,
	issuing <var>NextChar</var> is invalid and cancels the request.		issuing <var>NextChar</var> is invalid and cancels the request.
	<li>Once <var>NextChar</var> executes, the number of the resulting position		<li>Once <var>NextChar</var> executes, the number of the resulting position
	can be returned by NextPosition.		can be returned by <var>NextPosition</var>.
	<li>The [[PeekChar (StringTokenizer function)\|PeekChar]] function also returns the value of the		<li>The <var>[[PeekChar (StringTokenizer function)\|PeekChar]]</var> function also returns the value of the
	next character, but it does not advance the tokenizing position.		next character, but it does not advance the tokenizing position.
	</ul>		</ul>
	==Examples==		=Examples==

	The following sequence of <var>Print</var> statements display,		The following sequence of <var>Print</var> statements display,
	respectively, <tt>E</tt>, <tt>x</tt>, <tt>a</tt>, and <tt>a</tt>,		respectively, <code>E</code>, <code>x</code>, <code>a</code>, and <code>a</code>,
	showing that the tokenizing position moves after <var>NextChar</var> completes		showing that the tokenizing position moves after <var>NextChar</var> completes
	but not after PeekChar completes:		but not after <var>PeekChar</var> completes:
	<p class="code">%tok:string = 'Example of peekChar'		<p class="code">%tok:string = 'Example of peekChar'
	Print %tok:nextChar		Print %tok:nextChar

JALWiccan: 1 revision

2012-07-05T20:59:39Z

1 revision

← Older revision	Revision as of 20:59, 5 July 2012
(No difference)

JAL2: /* Examples */

2012-07-05T20:59:38Z

Examples

← Older revision		Revision as of 20:59, 5 July 2012
Line 16:		Line 16:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <tt>True</tt>,		<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <code>True</code>,
	issuing <var>NextChar</var> is invalid and cancels the request.		issuing <var>NextChar</var> is invalid and cancels the request.
	<li>Once <var>NextChar</var> executes, the number of the resulting position		<li>Once <var>NextChar</var> executes, the number of the resulting position

JAL2: /* Examples */

2011-05-02T17:50:50Z

Examples

New page

{{Template:StringTokenizer:NextChar subtitle}}

This method returns the value of the character that is at the tokenizing position,
and it advances the tokenizing position past that character to the next character.
The tokenizing position is the value returned by [[NextPosition (StringTokenizer property)|NextPosition]].
==Syntax==
{{Template:StringTokenizer:NextChar syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string variable to receive the returned character value. </td></tr>
<tr><th>stringTokenizer</th>
<td>A <var>StringTokenizer</var> object expression.</td></tr>
</table>

==Usage notes==
<ul>
<li>If the value of [[AtEnd (StringTokenizer function)|AtEnd]] is <tt>True</tt>,
issuing <var>NextChar</var> is invalid and cancels the request.
<li>Once <var>NextChar</var> executes, the number of the resulting position
can be returned by NextPosition.
<li>The [[PeekChar (StringTokenizer function)|PeekChar]] function also returns the value of the
next character, but it does not advance the tokenizing position.
</ul>
==Examples==

The following sequence of <var>Print</var> statements display,
respectively, <tt>E</tt>, <tt>x</tt>, <tt>a</tt>, and <tt>a</tt>,
showing that the tokenizing position moves after <var>NextChar</var> completes
but not after PeekChar completes:
<p class="code">%tok:string = 'Example of peekChar'
Print %tok:nextChar
Print %tok:nextChar
Print %tok:peekChar
Print %tok:peekChar
</p>

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

Dme: /* Syntax terms */

2011-02-19T03:43:42Z

Syntax terms

New page

{{Template:StringTokenizer:NextChar subtitle}}

This method returns the value of the character that is at the tokenizing position,
and it advances the tokenizing position past that character to the next character.
The tokenizing position is the value returned by [[NextPosition (StringTokenizer property)|NextPosition]].
==Syntax==
{{Template:StringTokenizer:NextChar syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%string</th>
<td>A string variable to receive the returned character value. </td></tr>
<tr><th>stringTokenizer</th>
<td>A <var>StringTokenizer</var> object.</td></tr>
</table>

==Usage notes==
<ul>
<li>If the value of [[AtEnd (StringTokenizer function)|AtEnd]] is <tt>True</tt>,
issuing <var>NextChar</var> is invalid and cancels the request.
<li>Once <var>NextChar</var> executes, the number of the resulting position
can be returned by NextPosition.
<li>The [[PeekChar (StringTokenizer function)|PeekChar]] function also returns the value of the
next character, but it does not advance the tokenizing position.
</ul>
==Examples==

The following sequence of printText statements display,
respectively, <tt>E</tt>, <tt>x</tt>, <tt>a</tt>, and <tt>a</tt>,
showing that the tokenizing position moves after <var>NextChar</var> completes
but not after PeekChar completes:
<p class="code">%tok:string = 'Example of peekChar'
Print %tok:nextChar
Print %tok:nextChar
Print %tok:peekChar
Print %tok:peekChar
</p>
==See also==
{{Template:StringTokenizer:NextChar footer}}

Wiccan: 1 revision

2011-02-06T21:48:05Z

1 revision

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

Wiccan: 1 revision

2011-02-06T21:48:03Z

1 revision

← Older revision		Revision as of 21:48, 6 February 2011
Line 28:		Line 28:
	showing that the tokenizing position moves after <var>NextChar</var> completes		showing that the tokenizing position moves after <var>NextChar</var> completes
	but not after PeekChar completes:		but not after PeekChar completes:
	<~~pre~~>		<p class="code">%tok:string = 'Example of peekChar'
	%tok:string = 'Example of peekChar'		Print %tok:nextChar
	Print %tok:nextChar		Print %tok:nextChar
	Print %tok:nextChar		Print %tok:peekChar
	Print %tok:peekChar		Print %tok:peekChar
	Print %tok:peekChar		</p>
	</~~pre~~>
	==See also==		==See also==
	{{Template:StringTokenizer:NextChar footer}}		{{Template:StringTokenizer:NextChar footer}}

Wiccan: 1 revision

2011-02-06T21:47:21Z

1 revision

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

Wiccan: 1 revision

2011-02-06T21:47:18Z

1 revision

← Older revision		Revision as of 21:47, 6 February 2011
Line 11:		Line 11:
	<td>A string variable to receive the returned character value. </td></tr>		<td>A string variable to receive the returned character value. </td></tr>
	<tr><th>%tok</th>		<tr><th>%tok</th>
	<td>A StringTokenizer object variable.</td></tr>		<td>A <var>StringTokenizer</var> object variable.</td></tr>
	</table>		</table>
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <tt>True</tt>,		<li>If the value of [[AtEnd (StringTokenizer function)\|AtEnd]] is <tt>True</tt>,
	issuing NextChar is invalid and cancels the request.		issuing <var>NextChar</var> is invalid and cancels the request.
	<li>Once NextChar executes, the number of the resulting position		<li>Once <var>NextChar</var> executes, the number of the resulting position
	can be returned by NextPosition.		can be returned by NextPosition.
	<li>The [[PeekChar (StringTokenizer function)\|PeekChar]] function also returns the value of the		<li>The [[PeekChar (StringTokenizer function)\|PeekChar]] function also returns the value of the
Line 26:		Line 26:
	The following sequence of printText statements display,		The following sequence of printText statements display,
	respectively, <tt>E</tt>, <tt>x</tt>, <tt>a</tt>, and <tt>a</tt>,		respectively, <tt>E</tt>, <tt>x</tt>, <tt>a</tt>, and <tt>a</tt>,
	showing that the tokenizing position moves after NextChar completes		showing that the tokenizing position moves after <var>NextChar</var> completes
	but not after PeekChar completes:		but not after PeekChar completes:
	<pre>		<pre>