AddUnique (Stringlist function) - Revision history

Dme: /* Usage notes */

2018-06-14T10:18:31Z

Usage notes

← Older revision		Revision as of 10:18, 14 June 2018
Line 24:		Line 24:
	<li>All errors in <var>AddUnique</var> result in request cancellation.		<li>All errors in <var>AddUnique</var> result in request cancellation.
	<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.		<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.
	<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases &~~amp;~~mdash; for example, if the target <var>Stringlist</var> starts out unordered.		<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases — for example, if the target <var>Stringlist</var> starts out unordered.
	</ul>		</ul>

Admin: /* Examples */

2012-10-10T18:49:43Z

Examples

← Older revision		Revision as of 18:49, 10 October 2012
Line 28:		Line 28:

	==Examples==		==Examples==
	~~<ol><li>~~<var>AddUnique</var> returns the item number added (if no match was found) or the negative item number of the matching item (if one was found). This return code makes it easy to maintain a parallel <var>Stringlist</var> that contains, say, a count of the number of times a given value occurred, that is, was passed as a string to <var>AddUnique</var>. The following example illustrates such an approach:		<var>AddUnique</var> returns the item number added (if no match was found) or the negative item number of the matching item (if one was found). This return code makes it easy to maintain a parallel <var>Stringlist</var> that contains, say, a count of the number of times a given value occurred, that is, was passed as a string to <var>AddUnique</var>. The following example illustrates such an approach:
	<p class="code">%in = %olist:addUnique(%data)		<p class="code">%in = %olist:addUnique(%data)
	if %in gt 0 then		if %in gt 0 then
Line 36:		Line 36:
	%clist:replace(%in, %clist:item(%in) + 1)		%clist:replace(%in, %clist:item(%in) + 1)
	end if		end if
	</p~~></ol~~>		</p>

	==See also==		==See also==
	{{Template:Stringlist:AddUnique footer}}		{{Template:Stringlist:AddUnique footer}}

JALWiccan: 1 revision

2011-07-14T19:40:23Z

1 revision

← Older revision	Revision as of 19:40, 14 July 2011
(No difference)

JAL at 19:40, 14 July 2011

2011-07-14T19:40:22Z

← Older revision		Revision as of 19:40, 14 July 2011
Line 1:		Line 1:
	{{Template:Stringlist:AddUnique subtitle}}		{{Template:Stringlist:AddUnique subtitle}}

	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] method adds an item to a <var>Stringlist</var> if an identical item is not already present. It adds the item to the end of the <var>Stringlist</var>. <var>AddUnique</var> accepts one argument and returns one of the following:		This [[Notation conventions for methods#Callable functions\|callable]] method adds an item to a <var>Stringlist</var> if an identical item is not already present. It adds the item to the end of the <var>Stringlist</var>. <var>AddUnique</var> accepts one argument and returns one of the following:

	<ul>		<ul>
Line 24:		Line 24:
	<li>All errors in <var>AddUnique</var> result in request cancellation.		<li>All errors in <var>AddUnique</var> result in request cancellation.
	<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.		<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.
	<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases — for example, if the target <var>Stringlist</var> starts out unordered.		<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases &mdash; for example, if the target <var>Stringlist</var> starts out unordered.
	</ul>		</ul>

JAL at 00:42, 9 March 2011

2011-03-09T00:42:40Z

← Older revision		Revision as of 00:42, 9 March 2011
Line 1:		Line 1:
	{{Template:Stringlist:AddUnique subtitle}}		{{Template:Stringlist:AddUnique subtitle}}

	This callable method adds an item to a <var>Stringlist</var> if an identical item is not already present. It adds the item to the end of the <var>Stringlist</var>. <var>AddUnique</var> accepts one argument and returns one of the following:		This [[Notation conventions for methods#Callable methods\|callable]] method adds an item to a <var>Stringlist</var> if an identical item is not already present. It adds the item to the end of the <var>Stringlist</var>. <var>AddUnique</var> accepts one argument and returns one of the following:

	<ul>		<ul>

JAL: /* Usage notes */

2011-03-08T21:09:17Z

Usage notes

← Older revision		Revision as of 21:09, 8 March 2011
Line 24:		Line 24:
	<li>All errors in <var>AddUnique</var> result in request cancellation.		<li>All errors in <var>AddUnique</var> result in request cancellation.
	<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.		<li><var>AddUnique</var> always adds the indicated string to the end of the <var>Stringlist</var>, but it does not add it if there is already an identical <var>Stringlist</var> item on the <var>Stringlist</var>.
	<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases -- for example, if the target <var>Stringlist</var> starts out unordered.		<li><var>AddUnique</var> does not assume any order for the <var>Stringlist</var>, so it sequentially scans the entire <var>Stringlist</var> for matches to the string being added. Because of this, it is generally more expensive to use than <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var> for very large <var>Stringlists</var>. <var>[[AddUniqueOrdered (Stringlist_function)\|AddUniqueOrdered]]</var>, however, may not be usable in all cases — for example, if the target <var>Stringlist</var> starts out unordered.
	</ul>		</ul>

Dme: /* Examples */

2011-02-07T22:48:45Z

Examples

← Older revision		Revision as of 22:48, 7 February 2011
Line 31:		Line 31:
	<p class="code">%in = %olist:addUnique(%data)		<p class="code">%in = %olist:addUnique(%data)
	if %in gt 0 then		if %in gt 0 then
	%clist:insert(%in, 1)		%clist:insert(%in, 1)
	~~</p>~~
	else		else
	~~<p class="code">~~%in = -%in		%in = -%in
	%clist:replace(%in, %clist:item(%in) + 1)		%clist:replace(%in, %clist:item(%in) + 1)
	~~</p>~~
	end if		end if
	</p></ol>		</p></ol>

Wiccan: 1 revision

2011-02-07T21:23:52Z

1 revision

← Older revision	Revision as of 21:23, 7 February 2011
(No difference)

Wiccan: 1 revision

2011-02-07T21:23:51Z

1 revision

← Older revision		Revision as of 21:23, 7 February 2011
Line 31:		Line 31:
	<p class="code">%in = %olist:addUnique(%data)		<p class="code">%in = %olist:addUnique(%data)
	if %in gt 0 then		if %in gt 0 then
	~~<p class="code">~~%clist:insert(%in, 1)		%clist:insert(%in, 1)
	</p>		</p>
	else		else

Wiccan: 1 revision

2011-02-06T22:35:22Z

1 revision

← Older revision	Revision as of 22:35, 6 February 2011
(No difference)