NextPosition (StringTokenizer property) - Revision history

JAL: /* Examples */

2012-11-15T20:31:57Z

Examples

← Older revision		Revision as of 20:31, 15 November 2012
Line 50:		Line 50:
	%tok = new		%tok = new
	%tok:string = 'This is the nextPosition example.'		%tok:string = 'This is the nextPosition example.'
	~~printText~~ {~} is {%tok:nextToken}		[[Targeted Text statements#AuditText, PrintText, and TraceText\|PrintText]] {~} is {%tok:nextToken}
	printText {~} is {%tok:nextToken}		printText {~} is {%tok:nextToken}
	printText {~} is {%tok:nextToken}		printText {~} is {%tok:nextToken}

JAL at 20:15, 15 November 2012

2012-11-15T20:15:48Z

← Older revision		Revision as of 20:15, 15 November 2012
Line 1:		Line 1:
	{{Template:StringTokenizer:NextPosition subtitle}}		{{Template:StringTokenizer:NextPosition subtitle}}

	This readWrite property returns		This [[Classes and Objects#readWrite\|readWrite]] property returns
	or sets the tokenizing position, the position of the character		or sets the tokenizing position, the position of the character
	from which the parsing of the next token begins.		from which the parsing of the next token begins.

JAL2 at 00:07, 6 July 2012

2012-07-06T00:07:44Z

← Older revision		Revision as of 00:07, 6 July 2012
Line 5:		Line 5:
	from which the parsing of the next token begins.		from which the parsing of the next token begins.
	Its initial value is 1.		Its initial value is 1.
	~~Unless you explicitly set it otherwise, the tokenizing position is~~
	~~the position that follows the (last) character in the value returned by the~~
	~~most recent call of [[NextToken (StringTokenizer function)\|NextToken]],~~
	~~[[FindToken (StringTokenizer function)\|FindToken]], or [[NextChar (StringTokenizer function)\|NextChar]].~~

	~~Well~~, ~~not exactly~~. [[??]] ~~For example~~, <var>SkipTokens</var> ~~& PreviousChar affect~~ it~~, and if~~ token is quoted (& all ~~else defaults~~)~~, it's position after~~ quote.		The tokenizing position depends on the methods that precede it.
			Each call of <var>[[NextToken (StringTokenizer function)\|NextToken]]</var>,
			<var>[[FindToken (StringTokenizer function)\|FindToken]]</var>, or <var>[[NextChar (StringTokenizer function)\|NextChar]]</var>, for example, moves the tokenizing position to
			the position that follows the (last) character in the value returned by these methods. <var>[[PreviousChar (StringTokenizer function)\|PreviousChar]]</var> moves the tokenizing position to the preceding character, and <var>[[SkipTokens (StringTokenizer subroutine)\|SkipTokens]]</var> moves the tokenizing position to follow the last character in the last token to which it advances. If a token is quoted, the tokenizing position (in all-default situations) follows the ending quote character.

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

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentNumber</th>		<tr><th>%currentNumber</th>
	<td>A numeric variable to contain the value of the current tokenizing position.</td></tr>		<td>A numeric variable to contain the value of the current tokenizing position.</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 expression.</td></tr>

	<tr><th>newNumber</th>		<tr><th>newNumber</th>
	<td>The numeric value to assign to <var class="term">stringTokenizer</var>'s <var>NextPosition</var> property.</td></tr>		<td>The numeric value to assign to <var class="term">stringTokenizer</var>'s <var>NextPosition</var> property.</td></tr>
Line 29:		Line 32:
	Setting <var>NextPosition</var> does not change <var>CurrentTokenPosition</var>.		Setting <var>NextPosition</var> does not change <var>CurrentTokenPosition</var>.
	<li>To advance the current token position a single character, you can use		<li>To advance the current token position a single character, you can use
	[[NextChar ~~(StringTokenizer function)\|NextChar]]~~.		<var>NextChar</var>.
	If a <var>NextChar</var> function call immediately follows a <var>NextPosition</var> call,		If a <var>NextChar</var> function call immediately follows a <var>NextPosition</var> call,
	NextChar identifies the character whose position is the value of <var>NextPosition</var>.		<var>NextChar</var> identifies the character whose position is the value of <var>NextPosition</var>.
	<li>If you reset <var>NextPosition</var>, the value returned by your next <var>NextToken</var>,		<li>If you reset <var>NextPosition</var>, the value returned by your next <var>NextToken</var>,
	FindToken, [[SkipTokens ~~(StringTokenizer subroutine)\|SkipTokens]]~~, or <var>NextChar</var> call will be based on the reset <var>NextPosition</var> value.		<var>FindToken</var>, <var>SkipTokens</var>, or <var>NextChar</var> call will be based on the reset <var>NextPosition</var> value.

	The <var>NextPosition</var> value is entirely independent from the <var>CurrentTokenPosition</var> value,		The <var>NextPosition</var> value is entirely independent from the <var>CurrentTokenPosition</var> value,
Line 41:		Line 44:

	==Examples==		==Examples==

	In the following request fragment, <var>NextToken</var> calls retrieve the first three		In the following request fragment, <var>NextToken</var> calls retrieve the first three
	tokens in the string, then <var>NextPosition</var> is explicitly set back to the second		tokens in the string, then <var>NextPosition</var> is explicitly set back to the second
Line 65:		Line 67:
	%tok:nextPosition is 5		%tok:nextPosition is 5
	</p>		</p>

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

JALWiccan: 1 revision

2012-07-05T21:29:00Z

1 revision

← Older revision	Revision as of 21:29, 5 July 2012
(No difference)

JALWiccan: 1 revision

2012-07-05T21:28:59Z

1 revision

← Older revision		Revision as of 21:28, 5 July 2012
Line 35:		Line 35:
	FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or <var>NextChar</var> call will be based on the reset <var>NextPosition</var> value.		FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or <var>NextChar</var> call will be based on the reset <var>NextPosition</var> value.

	The <var>NextPosition</var> value is entirely independent from the <var>~~CurrentToken~~</var>~~Position~~ value,		The <var>NextPosition</var> value is entirely independent from the <var>CurrentTokenPosition</var> value,
	and vice versa.		and vice versa.
	Both properties can be set to arbitrary locations in the tokenization string.		Both properties can be set to arbitrary locations in the tokenization string.

JALWiccan: 1 revision

2012-07-05T21:26:34Z

1 revision

← Older revision		Revision as of 21:26, 5 July 2012
Line 30:		Line 30:
	<li>To advance the current token position a single character, you can use		<li>To advance the current token position a single character, you can use
	[[NextChar (StringTokenizer function)\|NextChar]].		[[NextChar (StringTokenizer function)\|NextChar]].
	If a NextChar function call immediately follows a <var>NextPosition</var> call,		If a <var>NextChar</var> function call immediately follows a <var>NextPosition</var> call,
	NextChar identifies the character whose position is the value of <var>NextPosition</var>.		NextChar identifies the character whose position is the value of <var>NextPosition</var>.
	<li>If you reset <var>NextPosition</var>, the value returned by your next <var>NextToken</var>,		<li>If you reset <var>NextPosition</var>, the value returned by your next <var>NextToken</var>,
	FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or NextChar call will be based on the reset <var>NextPosition</var> value.		FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or <var>NextChar</var> call will be based on the reset <var>NextPosition</var> value.

	The <var>NextPosition</var> value is entirely independent from the <var>CurrentToken</var>Position value,		The <var>NextPosition</var> value is entirely independent from the <var>CurrentToken</var>Position value,

JALWiccan: 1 revision

2012-07-05T21:25:47Z

1 revision

← Older revision	Revision as of 21:25, 5 July 2012
(No difference)

JALWiccan: 1 revision

2012-07-05T21:25:46Z

1 revision

← Older revision		Revision as of 21:25, 5 July 2012
Line 35:		Line 35:
	FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or NextChar call will be based on the reset <var>NextPosition</var> value.		FindToken, [[SkipTokens (StringTokenizer subroutine)\|SkipTokens]], or NextChar call will be based on the reset <var>NextPosition</var> value.

	The <var>NextPosition</var> value is entirely independent from the ~~CurrentTokenPosition~~ value,		The <var>NextPosition</var> value is entirely independent from the <var>CurrentToken</var>Position value,
	and vice versa.		and vice versa.
	Both properties can be set to arbitrary locations in the tokenization string.		Both properties can be set to arbitrary locations in the tokenization string.

JALWiccan: 1 revision

2012-07-05T21:23:16Z

1 revision

← Older revision	Revision as of 21:23, 5 July 2012
(No difference)

JALWiccan: 1 revision

2012-07-05T21:23:15Z

1 revision

← Older revision		Revision as of 21:23, 5 July 2012
Line 10:		Line 10:
	[[FindToken (StringTokenizer function)\|FindToken]], or [[NextChar (StringTokenizer function)\|NextChar]].		[[FindToken (StringTokenizer function)\|FindToken]], or [[NextChar (StringTokenizer function)\|NextChar]].

	Well, not exactly. [[??]] For example, SkipTokens & PreviousChar affect it, and if token is quoted (& all else defaults), it's position after quote.		Well, not exactly. [[??]] For example, <var>SkipTokens</var> & PreviousChar affect it, and if token is quoted (& all else defaults), it's position after quote.
	==Syntax==		==Syntax==
	{{Template:StringTokenizer:NextPosition syntax}}		{{Template:StringTokenizer:NextPosition syntax}}