Quotes (StringTokenizer property) - Revision history

JAL: /* Examples */

2012-11-15T20:36:22Z

Examples

← Older revision		Revision as of 20:36, 15 November 2012
Line 44:		Line 44:

	==Examples==		==Examples==
	The following request fragment employs two quotation characters, and		The following request fragment employs two quotation characters, and
	it uses the <var>RemoveQuotes</var> method to include the quotation characters		it uses the <var>RemoveQuotes</var> method to include the quotation characters
	in the returned tokens:		in the returned tokens:

JAL2 at 00:47, 6 July 2012

2012-07-06T00:47:27Z

← Older revision		Revision as of 00:47, 6 July 2012
Line 5:		Line 5:
	The text between each disjoint pair of identical quotation characters		The text between each disjoint pair of identical quotation characters
	(a "quoted region") is treated as a single token, and any		(a "quoted region") is treated as a single token, and any
	delimiter characters (<var>Quotes</var>, <var>[[Spaces (StringTokenizer property)\|Spaces]]</var>, or <var>[[TokenChars (StringTokenizer property)\|TokenChars]]</var>)		delimiter characters (<var>Quotes</var>, <var>[[Spaces (StringTokenizer property)\|Spaces]]</var>, <var>[[TokenChars (StringTokenizer property)\|TokenChars]]</var>, or <var>[[Separators (StringTokenizer property)\|Separators]]</var>)
	within a quoted region are treated as non-delimiters.		within a quoted region are treated as non-delimiters.

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

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%currentString</th>		<tr><th>%currentString</th>
	<td>A string variable to contain the returned value of the current quotation characters.		<td>A string variable to contain the returned value of the current quotation characters.

	<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>newString</th>		<tr><th>newString</th>
	<td>The string value to assign to <var class="term">stringTokenizer</var>'s <var>Quotes</var> property. Each character in the string is a quotation character and no character may repeat. The default value for a new tokenizer is a null string.		<td>The string value to assign to <var class="term">stringTokenizer</var>'s <var>Quotes</var> property. Each character in the string is a quotation character and no character may repeat. The default value for a new tokenizer is a null string.
Line 25:		Line 28:
	<li>No character can be one of the <var>Quotes</var> characters and also be		<li>No character can be one of the <var>Quotes</var> characters and also be
	one of either the <var>Spaces</var> characters or the <var>TokenChars</var> characters.		one of either the <var>Spaces</var> characters or the <var>TokenChars</var> characters.
	<li>The <var>Quotes</var> characters are initially settable in the [[New (StringTokenizer constructor)\|New]] call that creates the tokenizer instance.
			<li>The <var>Quotes</var> characters are initially settable in the <var>[[New (StringTokenizer constructor)\|New]]</var> call that creates the tokenizer instance.

	<li>A quotation character may participate in only one quoted region.		<li>A quotation character may participate in only one quoted region.
	The first quotation character from the beginning of the tokenization string is		The first quotation character from the beginning of the tokenization string is
	paired with the following identical quotation character in the string.		paired with the following identical quotation character in the string.
	An unpaired quotation character causes a request cancellation.		An unpaired quotation character causes a request cancellation.

	<li>A quoted region is not affected by the <var>[[TokensToLower (StringTokenizer property)\|TokensToLower]]</var>		<li>A quoted region is not affected by the <var>[[TokensToLower (StringTokenizer property)\|TokensToLower]]</var>
	and <var>[[TokensToUpper (StringTokenizer property)\|TokensToUpper]]</var> properties.		and <var>[[TokensToUpper (StringTokenizer property)\|TokensToUpper]]</var> properties.

	<li>The <var>[[RemoveQuotes (StringTokenizer property)\|RemoveQuotes]]</var> property controls whether		<li>The <var>[[RemoveQuotes (StringTokenizer property)\|RemoveQuotes]]</var> property controls whether
	quotes are removed from the returned values of quoted tokens.		quotes are removed from the returned values of quoted tokens.
	</ul>		</ul>

	==Examples==		==Examples==
			The following request fragment employs two quotation characters, and
	The following request fragment employs two quotation characters, and
	it uses the <var>RemoveQuotes</var> method to include the quotation characters		it uses the <var>RemoveQuotes</var> method to include the quotation characters
	in the returned tokens:		in the returned tokens:
Line 53:		Line 60:
	"trivial"		"trivial"
	</p>		</p>

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

Dme at 16:03, 2 May 2011

2011-05-02T16:03:06Z

New page

{{Template:StringTokenizer:Quotes subtitle}}

This readWrite property returns or sets
the characters that are recognized as quotation characters.
The text between each disjoint pair of identical quotation characters
(a "quoted region") is treated as a single token, and any
delimiter characters (<var>Quotes</var>, <var>[[Spaces (StringTokenizer property)|Spaces]]</var>, or <var>[[TokenChars (StringTokenizer property)|TokenChars]]</var>)
within a quoted region are treated as non-delimiters.

==Syntax==
{{Template:StringTokenizer:Quotes syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%currentString</th>
<td>A string variable to contain the returned value of the current quotation characters.
<tr><th>stringTokenizer</th>
<td>A <var>StringTokenizer</var> object expression.</td></tr>
<tr><th>newString</th>
<td>The string value to assign to <var class="term">stringTokenizer</var>'s <var>Quotes</var> property. Each character in the string is a quotation character and no character may repeat. The default value for a new tokenizer is a null string.
</td></tr>
</table>

==Usage notes==
<ul>
<li>No character can be one of the <var>Quotes</var> characters and also be
one of either the <var>Spaces</var> characters or the <var>TokenChars</var> characters.
<li>The <var>Quotes</var> characters are initially settable in the [[New (StringTokenizer constructor)|New]] call that creates the tokenizer instance.
<li>A quotation character may participate in only one quoted region.
The first quotation character from the beginning of the tokenization string is
paired with the following identical quotation character in the string.
An unpaired quotation character causes a request cancellation.
<li>A quoted region is not affected by the <var>[[TokensToLower (StringTokenizer property)|TokensToLower]]</var>
and <var>[[TokensToUpper (StringTokenizer property)|TokensToUpper]]</var> properties.
<li>The <var>[[RemoveQuotes (StringTokenizer property)|RemoveQuotes]]</var> property controls whether
quotes are removed from the returned values of quoted tokens.
</ul>
==Examples==

The following request fragment employs two quotation characters, and
it uses the <var>RemoveQuotes</var> method to include the quotation characters
in the returned tokens:
<p class="code">%tok = new(Quotes='"+')
%tok:string = '+This Quotes example+ is "trivial"'
%tok:removeQuotes = False
Print %tok:nextToken
Print %tok:nextToken
Print %tok:nextToken
</p>

The result is:
<p class="output">+This Quotes example+
is
"trivial"
</p>
==See also==
{{Template:StringTokenizer:Quotes 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 14:		Line 14:
	<tr><th>%chars</th>		<tr><th>%chars</th>
	<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.		<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.
	~~<p class="code">~~If you are setting <var>Quotes</var>, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </td></tr>
	~~</p~~>		If you are setting <var>Quotes</var>, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </td></tr>
	<tr><th>%tok</th>		<tr><th>%tok</th>
	<td>A <var>StringTokenizer</var> object variable.</td></tr>		<td>A <var>StringTokenizer</var> object variable.</td></tr>

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 14:		Line 14:
	<tr><th>%chars</th>		<tr><th>%chars</th>
	<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.		<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.
	If you are setting <var>Quotes</var>, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </td></tr>		<p class="code">If you are setting <var>Quotes</var>, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </td></tr>
			</p>
	<tr><th>%tok</th>		<tr><th>%tok</th>
	<td>A <var>StringTokenizer</var> object variable.</td></tr>		<td>A <var>StringTokenizer</var> object variable.</td></tr>
Line 37:		Line 38:
	it uses the Remove<var>Quotes</var> method to include the quotation characters		it uses the Remove<var>Quotes</var> method to include the quotation characters
	in the returned tokens:		in the returned tokens:
	<~~pre~~>		<p class="code">%tok = new(<var>Quotes</var>='"+')
	%tok = new(<var>Quotes</var>='"+')		%tok:string = '+This <var>Quotes</var> example+ is "trivial"'
	%tok:string = '+This <var>Quotes</var> example+ is "trivial"'		%tok:remove<var>Quotes</var> = False
	%tok:remove<var>Quotes</var> = False		Print %tok:nextToken
	Print %tok:nextToken		Print %tok:nextToken
	Print %tok:nextToken		Print %tok:nextToken
	Print %tok:nextToken		</p>
	</~~pre~~>

	The result is:		The result is:
	<~~pre~~>		<p class="output">+This <var>Quotes</var> example+
	+This <var>Quotes</var> example+		is
	is		"trivial"
	"trivial"		</p>
	</~~pre~~>
	==See also==		==See also==
	{{Template:StringTokenizer:Quotes footer}}		{{Template:StringTokenizer:Quotes footer}}

Wiccan: 1 revision

2011-02-06T21:47:22Z

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 14:		Line 14:
	<tr><th>%chars</th>		<tr><th>%chars</th>
	<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.		<td>A string variable to contain the returned value of the current quotation characters or to be set as the new value. The default value for a new tokenizer is a null string.
	If you are setting Quotes, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </td></tr>		If you are setting <var>Quotes</var>, each character in the string is a quotation character — that is, you may not separate characters — and no character may repeat (except for apostrophe, which may be doubled). </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>No character can be one of the Quotes characters and also be		<li>No character can be one of the <var>Quotes</var> characters and also be
	one of either the Spaces characters or the TokenChars characters.		one of either the Spaces characters or the TokenChars characters.
	<li>The Quotes characters are initially settable in the [[New (StringTokenizer constructor)\|New]] call that creates the tokenizer instance.		<li>The <var>Quotes</var> characters are initially settable in the [[New (StringTokenizer constructor)\|New]] call that creates the tokenizer instance.
	<li>A quotation character may participate in only one quoted region.		<li>A quotation character may participate in only one quoted region.
	The first quotation character from the beginning of the tokenization string is		The first quotation character from the beginning of the tokenization string is
Line 35:		Line 35:

	The following request fragment employs two quotation characters, and		The following request fragment employs two quotation characters, and
	it uses the ~~RemoveQuotes~~ method to include the quotation characters		it uses the Remove<var>Quotes</var> method to include the quotation characters
	in the returned tokens:		in the returned tokens:
	<pre>		<pre>
	%tok = new(Quotes='"+')		%tok = new(<var>Quotes</var>='"+')
	%tok:string = '+This Quotes example+ is "trivial"'		%tok:string = '+This <var>Quotes</var> example+ is "trivial"'
	%tok:~~removeQuotes~~ = False		%tok:remove<var>Quotes</var> = False
	Print %tok:nextToken		Print %tok:nextToken
	Print %tok:nextToken		Print %tok:nextToken
Line 48:		Line 48:
	The result is:		The result is:
	<pre>		<pre>
	+This Quotes example+		+This <var>Quotes</var> example+
	is		is
	"trivial"		"trivial"

Wiccan: 1 revision

2011-02-06T19:55:21Z

1 revision

← Older revision	Revision as of 19:55, 6 February 2011
(No difference)