WordNumberIn and WordNumberOf (String functions) - Revision history

ELowell at 23:04, 3 September 2015

2015-09-03T23:04:04Z

← Older revision		Revision as of 23:04, 3 September 2015
Line 1:		Line 1:
	{{Template:String:WordNumberIn and WordNumberOf subtitle}}		{{Template:String:WordNumberIn and WordNumberOf subtitle}}

	The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case.		The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case.

Line 13:		Line 12:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th><td> A variable to receive the number of the first occurrence of the "needle" word in the "haystack" list of words. If the word "needle" is not one of the words in "haystack", <var class="term">%number</var> is set to 0.		<tr><th nowrap>%number</th><td> A variable to receive the number of the first occurrence of the "needle" word in the "haystack" list of words. If the word "needle" is not one of the words in "haystack", <var class="term">%number</var> is set to 0.
	</td></tr>		</td></tr>
	<tr><th>string</th>		<tr><th>string</th>

JAL: /* Examples */

2012-11-05T23:15:41Z

Examples

← Older revision		Revision as of 23:15, 5 November 2012
Line 40:		Line 40:
	PrintText {~='bb':WordNumberIn('aa bb cc')}		PrintText {~='bb':WordNumberIn('aa bb cc')}
	</p>		</p>
	produces ~~the following~~ result:		produces this result:
	<p class="output">'aa bb cc':WordNumberOf('bb')=2		<p class="output">'aa bb cc':WordNumberOf('bb')=2
	'bb':WordNumberIn('aa bb cc')=2		'bb':WordNumberIn('aa bb cc')=2

JAL2 at 18:51, 21 March 2012

2012-03-21T18:51:50Z

← Older revision		Revision as of 18:51, 21 March 2012
Line 1:		Line 1:
	{{Template:String:WordNumberIn and WordNumberOf subtitle}}		{{Template:String:WordNumberIn and WordNumberOf subtitle}}

	The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case. The difference between the two methods is that for <var>WordNumberIn</var>, the method object string is the "needle" and the first argument is the "haystack", whereas for <var>WordNumberOf</var>, the first argument is the "needle" and the method object string is the "haystack". Which method is more convenient to use will be application dependent.		The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case.

			The only difference between the two methods is that for <var>WordNumberIn</var>, the method object string is the "needle" and the first argument is the "haystack", whereas for <var>WordNumberOf</var>, the first argument is the "needle" and the method object string is the "haystack". Which method is more convenient to use will be application dependent.

	<p></p>		<p></p>
Line 29:		Line 31:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li><var>WordNumberIn</var> ~~and <var>WordNumberOf</var> do exactly the same thing. The only difference between them~~ is ~~that in <var>WordNumberOf</var>, the "haystack" is the method object <var class="term">string</var> and~~ the <var ~~class="term"~~>~~needle~~</var> is the first argument. In <var>WordNumberIn</var>, these roles are reversed: the "needle" is the method object <var class="term">string</var> and the <var class="term">haystack</var> is the first argument.		<li><var>WordNumberIn</var> is the OO version of <var>[[$Lstr_Windex]]</var>.
	~~Which method is preferable will depend on the application, and, in many cases, it will be quite arbitrary which one is used~~.
	</ul>		</ul>

	==Examples==		==Examples==
	<ol>		<ol>
Line 58:		Line 60:
	<ul>		<ul>
	<li>[[List of StringTokenizer methods]]		<li>[[List of StringTokenizer methods]]
	<li>[[Word (String function)\|Word]] ~~- Select~~ word from list of words		<li><var>[[Word (String function)\|Word]]</var>, which selects a word from a list of words
	<li>[[Words (String function)\|Words]] ~~- Sublist of~~ list of words		<li><var>[[Words (String function)\|Words]]</var>, which produces a word sublist from a list of words
	<li>[[WordCount (String function)\|WordCount]] ~~- Count words in list~~		<li><var>[[WordCount (String function)\|WordCount]]</var>, which counts the words in a list
	~~<li><var>WordNumberIn~~</var> is the ~~OO version of <var>$Lstr_Windex</var>.~~
	</ul>		</ul>
	{{Template:String:WordNumberIn footer}}		{{Template:String:WordNumberIn footer}}

JAL2: /* Examples */

2012-03-21T18:43:21Z

Examples

← Older revision		Revision as of 18:43, 21 March 2012
Line 33:		Line 33:
	</ul>		</ul>
	==Examples==		==Examples==
	The following fragment:		<ol>
			<li>The following fragment:
	<p class="code">PrintText {~='aa bb cc':WordNumberOf('bb')}		<p class="code">PrintText {~='aa bb cc':WordNumberOf('bb')}
	PrintText {~='bb':WordNumberIn('aa bb cc')}		PrintText {~='bb':WordNumberIn('aa bb cc')}
Line 41:		Line 42:
	'bb':WordNumberIn('aa bb cc')=2		'bb':WordNumberIn('aa bb cc')=2
	</p>		</p>
	You can use <var>WordNumberIn</var> and <var>[[Word (String function)\|Word]]</var> as
			<li>You can use <var>WordNumberIn</var> and <var>[[Word (String function)\|Word]]</var> as
	"quick and dirty" <var>[[NamedArraylist class\|NamedArraylists]]</var>:		"quick and dirty" <var>[[NamedArraylist class\|NamedArraylists]]</var>:
	<p class="code">%x = 'PA'		<p class="code">%x = 'PA'
Line 51:		Line 53:
	However, as the number of words grows large, repeated use of <var>WordNumberIn</var>		However, as the number of words grows large, repeated use of <var>WordNumberIn</var>
	is less efficient than using a <var>NamedArrayList</var>.		is less efficient than using a <var>NamedArrayList</var>.
			</ol>

	==See also==		==See also==
	<ul>		<ul>

Dme: /* See also */

2011-07-19T20:49:16Z

Dme at 16:43, 28 April 2011

2011-04-28T16:43:39Z

← Older revision		Revision as of 16:43, 28 April 2011
Line 1:		Line 1:
	{{Template:String:WordNumberIn and WordNumberOf subtitle}}		{{Template:String:WordNumberIn and WordNumberOf subtitle}}

	The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case. The difference between the two methods is that for <var>WordNumberIn</var>, the method object string is the "needle" and the first argument is the "haystack", whereas for <var>WordNumberOf</var>, the first argument is the "needle" and the method object string is the "haystack". Which method is more convenient to use will be application dependent.		The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case. The difference between the two methods is that for <var>WordNumberIn</var>, the method object string is the "needle" and the first argument is the "haystack", whereas for <var>WordNumberOf</var>, the first argument is the "needle" and the method object string is the "haystack". Which method is more convenient to use will be application dependent.

Line 11:		Line 11:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th><td> A variable to receive the number of the first occurrence of the ~~<var class=~~"~~term~~"~~>needle</var>~~ word in the ~~<var class=~~"~~term~~"~~>haystack</var>~~ list of words. If the word ~~<var class=~~"~~term~~"~~>needle</var>~~ is not one of the words in ~~<var class=~~"~~term~~"~~>haystack</var>~~, <var class="term">%number</var> is set to 0.		<tr><th>%number</th><td> A variable to receive the number of the first occurrence of the "needle" word in the "haystack" list of words. If the word "needle" is not one of the words in "haystack", <var class="term">%number</var> is set to 0.
	</td></tr>		</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>The method object string~~. Depending upon whether the <var>WordNumberIn</var> or <var>WordNumberOf</var> function is being used, <var class="term">string</var> may be~~ either ~~the~~: <ul><li>search target ~~<var class=~~"~~term">~~needle~~</var>~~, when called as <var>WordNumberIn</var> <li>the ~~search space <var class=~~"~~term">~~haystack~~</var>~~, when called as <var>WordNumberOf</var></ul>		<td>The method object string; either:
	</td></tr>		<ul><li>the search target "needle," when called as <var>WordNumberIn</var>
			<li>the list of words "haystack," when called as <var>WordNumberOf</var></ul></td></tr>
	<tr><th>haystack</th>		<tr><th>haystack</th>
	<td>~~The~~ list of words within which the <var class="term">~~needle~~</var> is searched for.		<td>In <var>WordNumberIn</var>, the list of words within which the
			<var class="term">string</var> method object (the "needle") is searched for.</td></tr>
	<tr><th>needle</th>		<tr><th>needle</th>
	<td>~~The~~ word ~~which is~~ searched for in the <var class="term">~~haystack~~</var>.		<td>In <var>WordNumberOf</var>, the word to be searched for within the <var class="term">string</var> method object list of words (the "haystack").</td></tr>
	</td></tr>
	<tr><th><var>Spaces</var></th>		<tr><th><var>Spaces</var></th>
	<td>A set of "whitespace" characters, that is, characters that separate words. The default is the blank character. If the null string is provided, the blank character is used as the whitespace character.		<td>A set of "whitespace" characters, that is, characters that separate words. The default is the blank character. If the null string is provided, the blank character is used as the whitespace character.
	</td></tr>		</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
			<ul>
			<li><var>WordNumberIn</var> and <var>WordNumberOf</var> do exactly the same thing. The only difference between them is that in <var>WordNumberOf</var>, the "haystack" is the method object <var class="term">string</var> and the <var class="term">needle</var> is the first argument. In <var>WordNumberIn</var>, these roles are reversed: the "needle" is the method object <var class="term">string</var> and the <var class="term">haystack</var> is the first argument.
			Which method is preferable will depend on the application, and, in many cases, it will be quite arbitrary which one is used.
			</ul>
	==Examples==		==Examples==
	The following fragment:		The following fragment:
Line 46:		Line 51:
	However, as the number of words grows large, repeated use of <var>WordNumberIn</var>		However, as the number of words grows large, repeated use of <var>WordNumberIn</var>
	is less efficient than using a <var>NamedArrayList</var>.		is less efficient than using a <var>NamedArrayList</var>.

	==See also==		==See also==
	<ul>		<ul>
	<li>[[List of StringTokenizer methods]]		<li>[[List of StringTokenizer methods]]
	~~<li><var>[[Word (String function)\|Word]]</var> - Select word from list of words~~
	~~<li><var>[[Words (String function)\|Words]]</var> - Sublist of list of words~~
	~~<li><var>[[WordCount (String function)\|WordCount]]</var> - Count words in list~~
	<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.		<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.
	</ul>		</ul>
	{{Template:String:WordNumberIn footer}}		{{Template:String:WordNumberIn footer}}

Dme at 19:13, 27 April 2011

2011-04-27T19:13:40Z

← Older revision		Revision as of 19:13, 27 April 2011
Line 50:		Line 50:
	<ul>		<ul>
	<li>[[List of StringTokenizer methods]]		<li>[[List of StringTokenizer methods]]
			<li><var>[[Word (String function)\|Word]]</var> - Select word from list of words
			<li><var>[[Words (String function)\|Words]]</var> - Sublist of list of words
			<li><var>[[WordCount (String function)\|WordCount]]</var> - Count words in list
	<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.		<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.
	</ul>		</ul>
	{{Template:String:WordNumberIn footer}}		{{Template:String:WordNumberIn footer}}

Dme at 18:10, 27 April 2011

2011-04-27T18:10:06Z

New page

{{Template:String:WordNumberIn and WordNumberOf subtitle}}

The <var>WordNumberIn</var> and <var>WordNumberOf</var> functions return the word number of the first occurrence of one word (the "needle") within a list of words ("the haystack"). The search respects character case. The difference between the two methods is that for <var>WordNumberIn</var>, the method object string is the "needle" and the first argument is the "haystack", whereas for <var>WordNumberOf</var>, the first argument is the "needle" and the method object string is the "haystack". Which method is more convenient to use will be application dependent.

<p></p>
Note that processing a string of words may be better accomplished with the <var>[[StringTokenizer class|StringTokenizer]]</var> class.

==Syntax==
{{Template:String:WordNumberIn syntax}}
{{Template:String:WordNumberOf syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%number</th><td> A variable to receive the number of the first occurrence of the <var class="term">needle</var> word in the <var class="term">haystack</var> list of words. If the word <var class="term">needle</var> is not one of the words in <var class="term">haystack</var>, <var class="term">%number</var> is set to 0.
</td></tr>
<tr><th>string</th>
<td>The method object string. Depending upon whether the <var>WordNumberIn</var> or <var>WordNumberOf</var> function is being used, <var class="term">string</var> may be either the: <ul><li>search target <var class="term">needle</var>, when called as <var>WordNumberIn</var> <li>the search space <var class="term">haystack</var>, when called as <var>WordNumberOf</var></ul>
</td></tr>
<tr><th>haystack</th>
<td>The list of words within which the <var class="term">needle</var> is searched for.
<tr><th>needle</th>
<td>The word which is searched for in the <var class="term">haystack</var>.
</td></tr>
<tr><th><var>Spaces</var></th>
<td>A set of "whitespace" characters, that is, characters that separate words. The default is the blank character. If the null string is provided, the blank character is used as the whitespace character.
</td></tr>
</table>

==Usage notes==
==Examples==
The following fragment:
<p class="code">PrintText {~='aa bb cc':WordNumberOf('bb')}
PrintText {~='bb':WordNumberIn('aa bb cc')}
</p>
produces the following result:
<p class="output">'aa bb cc':WordNumberOf('bb')=2
'bb':WordNumberIn('aa bb cc')=2
</p>
You can use <var>WordNumberIn</var> and <var>[[Word (String function)|Word]]</var> as
"quick and dirty" <var>[[NamedArraylist class|NamedArraylists]]</var>:
<p class="code">%x = 'PA'
%w = %x:WordNumberIn -
('MA PA MN')
%s = ('Massachusetts Pennsylvania Minnesota'):Word(%w)
Print 'Full state name:' And %s
</p>
However, as the number of words grows large, repeated use of <var>WordNumberIn</var>
is less efficient than using a <var>NamedArrayList</var>.

==See also==
<ul>
<li>[[List of StringTokenizer methods]]
<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.
</ul>
{{Template:String:WordNumberIn footer}}

Admin: 1 revision

2011-04-27T17:08:37Z

1 revision

← Older revision	Revision as of 17:08, 27 April 2011
(No difference)

JAL: /* Examples */

2011-04-27T15:20:26Z

Examples

New page

{{Template:String:WordNumberIn subtitle}}

<p></p>
Note that processing a string of words may be better accomplished with the <var>[[StringTokenizer class|StringTokenizer]]</var> class.

==Syntax==
{{Template:String:WordNumberIn syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%number</th><td> A variable to receive the number of the first occurrence of the <var class="term">needle</var> word in the <var class="term">haystack</var> list of words. If the word <var class="term">needle</var> is not one of the words in <var class="term">haystack</var>, <var class="term">%number</var> is set to 0.
</td></tr>
<tr><th>string</th>
<td>The method object string. Depending upon whether the <var>WordNumberIn</var> or <var>WordNumberOf</var> function is being used, <var class="term">string</var> may be either the: <ul><li>search target <var class="term">needle</var>, when called as <var>WordNumberIn</var> <li>the search space <var class="term">haystack</var>, when called as <var>WordNumberOf</var></ul>
</td></tr>
<tr><th>haystack</th>
<td>The list of words within which the <var class="term">needle</var> is searched for.
<tr><th>needle</th>
<td>The word which is searched for in the <var class="term">haystack</var>.
</td></tr>
<tr><th><var>Spaces</var></th>
<td>A set of "whitespace" characters, that is, characters that separate words. The default is the blank character. If the null string is provided, the blank character is used as the whitespace character.
</td></tr>
</table>
==Usage notes==
==Examples==
The following fragment:
<p class="code">PrintText {~='aa bb cc':WordNumberOf('bb')}
PrintText {~='bb':WordNumberIn('aa bb cc')}
</p>
produces the following result:
<p class="output">'aa bb cc':WordNumberOf('bb')=2
'bb':WordNumberIn('aa bb cc')=2
</p>
You can use <var>WordNumberIn</var> and <var>[[Word (String function)|Word]]</var> as
"quick and dirty" <var>[[NamedArraylist class|NamedArraylists]]</var>:
<p class="code">%x = 'PA'
%w = %x:WordNumberIn -
('MA PA MN')
%s = ('Massachusetts Pennsylvania Minnesota'):Word(%w)
Print 'Full state name:' And %s
</p>
However, as the number of words grows large, repeated use of <var>WordNumberIn</var>
is less efficient than using a <var>NamedArrayList</var>.

==See also==
<ul>
<li>[[List of StringTokenizer methods]]
<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.
</ul>
{{Template:String:WordNumberIn footer}}

← Older revision		Revision as of 20:49, 19 July 2011
Line 55:		Line 55:
	<ul>		<ul>
	<li>[[List of StringTokenizer methods]]		<li>[[List of StringTokenizer methods]]
			<li>[[Word (String function)\|Word]] - Select word from list of words
			<li>[[Words (String function)\|Words]] - Sublist of list of words
			<li>[[WordCount (String function)\|WordCount]] - Count words in list
	<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.		<li><var>WordNumberIn</var> is the OO version of <var>$Lstr_Windex</var>.
	</ul>		</ul>
	{{Template:String:WordNumberIn footer}}		{{Template:String:WordNumberIn footer}}