$List Add Ordered - Revision history

JALWiccan: Automatically generated page update

2018-09-20T22:51:34Z

Automatically generated page update

← Older revision		Revision as of 22:51, 20 September 2018
Line 2:		Line 2:
	<span class="pageSubtitle">Add an item to an ordered $list</span>		<span class="pageSubtitle">Add an item to an ordered $list</span>

	<p class="warn"><b>Note: </b>~~Most Sirius~~ $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $List_Add_Ordered function is <var>[[AddOrdered (Stringlist function)\|AddOrdered]]</var>.</p>		<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $List_Add_Ordered function is <var>[[AddOrdered (Stringlist function)\|AddOrdered]]</var>.</p>

	This function adds an item to a (presumably) ordered $list, inserting the item at the proper position to maintain the $list's order.		This function adds an item to a (presumably) ordered $list, inserting the item at the proper position to maintain the $list's order.

JAL: misc cleanup

2016-09-23T17:26:52Z

misc cleanup

← Older revision		Revision as of 17:26, 23 September 2016
Line 8:		Line 8:
	<var>$List_Add_Ordered</var> accepts two arguments and returns the item number of the inserted string. It is a [[Calling Sirius Mods $functions\|callable]] $function.		<var>$List_Add_Ordered</var> accepts two arguments and returns the item number of the inserted string. It is a [[Calling Sirius Mods $functions\|callable]] $function.

	~~The first argument is the $list identifier of the $list to which the string is to be added. This is a required argument.~~

	~~The second argument is the string to add to the $list. This is a required argument.~~

	==Syntax==		==Syntax==
	<p class="syntax">[%RC =] $List_Add_Ordered(list, string)		<p class="syntax">[%rc =] $List_Add_Ordered(<span class="term">list</span>, <span class="term">string</span>)
	</p>		</p>
	~~<p>~~
	~~</p>~~
	~~<p>%RC is the item number of the added string.</p>~~

	~~All errors in~~ <var>$~~List_Add_Ordered~~</var> ~~result in request cancellation~~.		Where:
			<ul>
			<li><var class="term">%rc</var> is the item number of the added string.</li>

			<li><var class="term">list</var> is the $list identifier of the $list to which the string is to be added. This is a required argument. </li>

			<li><var class="term">string</var> is the string to add to the $list. This is a required argument. </li>
			</ul>

	<~~var~~>~~$List_Add_Ordered~~<~~/var~~> ~~always adds the indicated string even if that string already exists on the $list but the new item is inserted so that the $list is~~ in ~~EBCDIC order.~~ <var>$List_Add_Ordered</var> ~~assumes that the $list is~~ in ~~EBCDIC order so it does a pseudo binary search to locate the correct insertion point~~. ~~<var>$List_Add_Ordered~~</~~var~~> ~~does not validate that the $list is in order and, it it isn't, the insertion point is unpredictable.~~		==Usage notes==
			<ul>
			<li>All errors in <var>$List_Add_Ordered</var> result in request cancellation. </li>

	~~The following code builds~~ a ~~sorted output~~ $~~list from an input~~ $list.		<li><var>$List_Add_Ordered</var> always adds the indicated string, even if that string already exists on the $list, but the new item is inserted so that the $list is in EBCDIC order. <var>$List_Add_Ordered</var> assumes that the $list is in EBCDIC order, so it does a pseudo binary search to locate the correct insertion point. <var>$List_Add_Ordered</var> does not validate that the $list is in order and, it it isn't, the insertion point is unpredictable. </li>

	<~~p class="code"~~> ~~FOR %I FROM 1 TO~~ $~~ListCnt(%INLIST~~)		<li>While in general it would be more efficient to simply copy and sort (via $ListSort) the input $list, such a technique might be useful if the target $list already has a large number of items. </li>
	~~%STRING =~~ $~~ListInf(%INLIST~~, ~~%I)~~
	~~%RC =~~ $~~List_Add_Ordered(%OUTLIST, %STRING)~~
	~~END FOR~~
	</p>

	~~While in general it would be more efficient to simply copy and sort (via~~ $~~ListSort)~~ the ~~input~~ $list ~~such a technique might~~ be ~~useful if~~ the ~~target~~ $list ~~already~~ as ~~a large number of items~~.		<li>Because <var>$List_Add_Ordered</var> will insert items into the middle of a $list, it will be susceptible to the same page-splitting, sparse $list leaf page issues as [[$ListIns]]. </li>
			</ul>

	~~Because <var>$List_Add_Ordered</var> will insert items into the middle of~~ a $list ~~it will be susceptible to the same page-splitting, sparse~~ $list ~~leaf page issues as [[$ListIns]]~~.		==Example==
			The following code builds a sorted output $list from an input $list.

	~~This~~ $~~function is new in Version 6.3.~~<p>		<p class="code">For %i From 1 To $ListCnt(%inlist)
			%string = $ListInf(%inlist, %i)
			%rc = $List_Add_Ordered(%outlist, %string)
			End For
			</p>

	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==
Line 47:		Line 53:
	<li>Japanese functions</li>		<li>Japanese functions</li>
	<li>[[Media:SirfieldNew.pdf\|Sir2000 Field Migration Facility]]</li>		<li>[[Media:SirfieldNew.pdf\|Sir2000 Field Migration Facility]]</li>

	</ul>		</ul>

	~~</p>~~
	~~<p>~~
	~~</p>~~


	[[Category:$Functions\|$List_Add_Ordered]]		[[Category:$Functions\|$List_Add_Ordered]]

JALWiccan: Automatically generated page update

2015-02-19T23:09:08Z

Automatically generated page update

← Older revision		Revision as of 23:09, 19 February 2015
Line 46:		Line 46:
	<li>[[Janus Web Server]]</li>		<li>[[Janus Web Server]]</li>
	<li>Japanese functions</li>		<li>Japanese functions</li>
	<li>[[Media:SirfieldNew.pdf\|Sir2000 Field Migration Facility]</li>		<li>[[Media:SirfieldNew.pdf\|Sir2000 Field Migration Facility]]</li>

	</ul>		</ul>

JALWiccan: Automatically generated page update

2015-02-19T22:58:02Z

Automatically generated page update

← Older revision		Revision as of 22:58, 19 February 2015
Line 46:		Line 46:
	<li>[[Janus Web Server]]</li>		<li>[[Janus Web Server]]</li>
	<li>Japanese functions</li>		<li>Japanese functions</li>
	<li>[~~http~~:~~//m204wiki.rocketsoftware.com/images/4/4b/~~SirfieldNew.pdf Sir2000 Field Migration Facility]</li>		<li>[[Media:SirfieldNew.pdf\|Sir2000 Field Migration Facility]</li>

	</ul>		</ul>

JALWiccan: Automatically generated page update

2015-02-19T22:38:05Z

Automatically generated page update

← Older revision		Revision as of 22:38, 19 February 2015
Line 42:		Line 42:
	<li>[[Fast/Unload User Language Interface]]</li>		<li>[[Fast/Unload User Language Interface]]</li>
	<li>[[Media:JoclrNew.pdf\|Janus Open Client]]</li>		<li>[[Media:JoclrNew.pdf\|Janus Open Client]]</li>
	<li>[[Media:JosrvrNew.pdf\|Janus Open Server]</li>		<li>[[Media:JosrvrNew.pdf\|Janus Open Server]]</li>
	<li>[[Janus Sockets]]</li>		<li>[[Janus Sockets]]</li>
	<li>[[Janus Web Server]]</li>		<li>[[Janus Web Server]]</li>

JALWiccan: Automatically generated page update

2015-02-19T22:34:38Z

Automatically generated page update

← Older revision		Revision as of 22:34, 19 February 2015
Line 42:		Line 42:
	<li>[[Fast/Unload User Language Interface]]</li>		<li>[[Fast/Unload User Language Interface]]</li>
	<li>[[Media:JoclrNew.pdf\|Janus Open Client]]</li>		<li>[[Media:JoclrNew.pdf\|Janus Open Client]]</li>
	<li>[~~http~~:~~//m204wiki.rocketsoftware.com/images/1/17/~~JosrvrNew.pdf Janus Open Server]</li>		<li>[[Media:JosrvrNew.pdf\|Janus Open Server]</li>
	<li>[[Janus Sockets]]</li>		<li>[[Janus Sockets]]</li>
	<li>[[Janus Web Server]]</li>		<li>[[Janus Web Server]]</li>

JALWiccan: Automatically generated page update

2015-02-19T21:21:01Z

Automatically generated page update

← Older revision		Revision as of 21:21, 19 February 2015
Line 41:		Line 41:
	<li>[[List of $functions\|Sirius functions]]</li>		<li>[[List of $functions\|Sirius functions]]</li>
	<li>[[Fast/Unload User Language Interface]]</li>		<li>[[Fast/Unload User Language Interface]]</li>
	<li>[[Media:JoclrNew.pdf\|Janus Open Client]</li>		<li>[[Media:JoclrNew.pdf\|Janus Open Client]]</li>
	<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>		<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>
	<li>[[Janus Sockets]]</li>		<li>[[Janus Sockets]]</li>

JALWiccan: Automatically generated page update

2015-02-19T21:17:23Z

Automatically generated page update

← Older revision		Revision as of 21:17, 19 February 2015
Line 41:		Line 41:
	<li>[[List of $functions\|Sirius functions]]</li>		<li>[[List of $functions\|Sirius functions]]</li>
	<li>[[Fast/Unload User Language Interface]]</li>		<li>[[Fast/Unload User Language Interface]]</li>
	<li>[~~http~~:~~//m204wiki.rocketsoftware.com/images/4/4a/~~JoclrNew.pdf Janus Open Client]</li>		<li>[[Media:JoclrNew.pdf\|Janus Open Client]</li>
	<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>		<li>[http://m204wiki.rocketsoftware.com/images/1/17/JosrvrNew.pdf Janus Open Server]</li>
	<li>[[Janus Sockets]]</li>		<li>[[Janus Sockets]]</li>

JALWiccan: Automatically generated page update

2014-08-01T22:07:45Z

Automatically generated page update

← Older revision		Revision as of 22:07, 1 August 2014
Line 39:		Line 39:
	==Products authorizing {{PAGENAMEE}}==		==Products authorizing {{PAGENAMEE}}==
	<ul class="smallAndTightList">		<ul class="smallAndTightList">
	<li>[[Sirius functions]]</li>		<li>[[List of $functions\|Sirius functions]]</li>
	<li>[[Fast/Unload User Language Interface]]</li>		<li>[[Fast/Unload User Language Interface]]</li>
	<li>[http://m204wiki.rocketsoftware.com/images/4/4a/JoclrNew.pdf Janus Open Client]</li>		<li>[http://m204wiki.rocketsoftware.com/images/4/4a/JoclrNew.pdf Janus Open Client]</li>

JALWiccan: Automatically generated page update

2014-07-08T16:02:47Z

Automatically generated page update

← Older revision		Revision as of 16:02, 8 July 2014
Line 45:		Line 45:
	<li>[[Janus Sockets]]</li>		<li>[[Janus Sockets]]</li>
	<li>[[Janus Web Server]]</li>		<li>[[Janus Web Server]]</li>
	<li>[[Japanese functions]]</li>		<li>Japanese functions</li>
	<li>[http://m204wiki.rocketsoftware.com/images/4/4b/SirfieldNew.pdf Sir2000 Field Migration Facility]</li>		<li>[http://m204wiki.rocketsoftware.com/images/4/4b/SirfieldNew.pdf Sir2000 Field Migration Facility]</li>