NamedArraylist class - Revision history

SteveS at 22:00, 12 February 2026

2026-02-12T22:00:08Z

← Older revision		Revision as of 22:00, 12 February 2026
Line 29:		Line 29:
	%narl('Cleese') = 'John'		%narl('Cleese') = 'John'
	%narl('Gilliam') = 'Terry'		%narl('Gilliam') = 'Terry'
	%narl('~~Pallin~~') = 'Michael'		%narl('Palin') = 'Michael'
	%narl('Chapman') = 'Graham'		%narl('Chapman') = 'Graham'

Line 47:		Line 47:
	Terry Gilliam		Terry Gilliam
	Eric Idle		Eric Idle
	Michael ~~Pallin~~		Michael Palin
	</p>		</p>

JAL: typo

2014-11-11T22:43:33Z

typo

← Older revision		Revision as of 22:43, 11 November 2014
Line 32:		Line 32:
	%narl('Chapman') = 'Graham'		%narl('Chapman') = 'Graham'

	Print 'The American''s first name is ' %narl('Gilliam')		Print 'The American''s first name is ' %narl('Gilliam')

	print '*** Completely different:'		print '*** Completely different:'

JAL at 21:33, 11 July 2014

2014-07-11T21:33:01Z

← Older revision		Revision as of 21:33, 11 July 2014
Line 5:		Line 5:
	==About the GenericNamedArraylist class==		==About the GenericNamedArraylist class==
	The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.		The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.

			Looking up an item in a <var>NamedArraylist</var> by its name is only slightly
			(possibly immeasurably) more CPU intensive than looking up the
			item by number, either in a <var>NamedArraylist</var> or in an <var>Arraylist</var>.
			<var>NamedArraylist</var> items will also take up a bit more space in CCATEMP
			than <var>Arraylist</var> items — the extra space required to hold the names.
			Usually, this overhead should be minor.

			Because of their relatively low extra overhead, <var>NamedArraylists</var>
			should be used wherever their functionality may
			prove useful, without concern for performance (which will be quite good).

	<div id="NamedArraylist examples"><!--in case references to old section name-->		<div id="NamedArraylist examples"><!--in case references to old section name-->
	==Examples==		==Examples==
	The following code shows some of the <var>NamedArraylist</var> methods:		<ul>
			<li>The following code shows some of the <var>NamedArraylist</var> methods:
	<p class="code">%narl is collection NamedArraylist of longstring		<p class="code">%narl is collection NamedArraylist of longstring
	%i is float		%i is float
Line 38:		Line 50:
	</p>		</p>

	'''Note:''' The items are kept in EBCDIC order by their name.		<p class="note">'''Note:''' The items are kept in EBCDIC order by their name.
	This is always the case for <var>NamedArraylist</var> items.		This is always the case for <var>NamedArraylist</var> items. </p></li>

	For another example, suppose there is a <var>[[Recordset class\|Recordset]]</var> object		<li>For another example, suppose there is a <var>[[Recordset class\|Recordset]]</var> object
	in a file where field <code>ProductId</code> has a product ID and field <code>Quantity</code> has the number		in a file where field <code>ProductId</code> has a product ID and field <code>Quantity</code> has the number of items with that ID.
	of items with that ID.
	The product IDs are ten-character alphanumeric IDs, so they cannot be used as numeric subscripts.		The product IDs are ten-character alphanumeric IDs, so they cannot be used as numeric subscripts.
	Some records may have the same <code>ProductId</code> as others.		Some records may have the same <code>ProductId</code> as others.
Line 69:		Line 80:
	The value of the <code>Quantity</code> field is added to this 0, and the		The value of the <code>Quantity</code> field is added to this 0, and the
	total is stored under the product ID.		total is stored under the product ID.
	Subsequent requests for the same product ID will return the current running total for that product.		Subsequent requests for the same product ID will return the current running total for that product.</li>
			</ul>
	~~Looking up an item in a <var>NamedArraylist</var> by its name is only slightly~~
	~~(possibly immeasurably) more CPU intensive than looking up the~~
	~~item by number, either in a <var>NamedArraylist</var> or in an <var>Arraylist</var>.~~
	~~<var>NamedArraylist~~</~~var~~> ~~items will also take up a bit more space in CCATEMP~~
	~~than <var>Arraylist~~</~~var~~> ~~items — the extra space required to hold the names.~~
	~~Usually, this overhead should be minor.~~

	~~Because of their relatively low extra overhead, <var>NamedArraylists</var>~~
	~~should be used wherever their functionality may~~
	~~prove useful, without concern for performance (which will be quite good).~~

	==List of NamedArraylist methods==		==List of NamedArraylist methods==
	The [[List of NamedArraylist methods~~\|"List of NamedArraylist methods"~~]] shows all the class methods, with a brief description of each.		The [[List of NamedArraylist methods]] shows all the class methods, with a brief description of each.

	==See also==		==See also==
	<table>		<table>
	<tr><th>[[List of FloatNamedArraylist methods]]</th>		<tr><td>[[List of FloatNamedArraylist methods]]</td>
	<td>For a list of all methods in the <var>FloatNamedArraylist</var> class, with a brief description of each.</td></tr>		<td>For a list of all methods in the <var>FloatNamedArraylist</var> class, with a brief description of each.</td></tr>
	<tr><th>[[List of UnicodeNamedArraylist methods]]</th>
			<tr><td nowrap>[[List of UnicodeNamedArraylist methods]]</td>
	<td>For a list of all methods in the <var>UnicodeNamedArraylist</var> class, with a brief description of each.</td></tr>		<td>For a list of all methods in the <var>UnicodeNamedArraylist</var> class, with a brief description of each.</td></tr>
	<tr><th>[[Collections]]</th>
			<tr><td>[[Collections]]</td>
	<td>For background information about collections and <var>Arraylist</var>s and about		<td>For background information about collections and <var>Arraylist</var>s and about
	declaring <var>Arraylist</var> object variables.</td></tr>		declaring <var>Arraylist</var> object variables.</td></tr>
	<tr><th>[[Collections#Coding considerations for collections\|Coding
	considerations for collections]]</th>		<tr><td>[[Collections#Coding considerations for collections\|Coding
			considerations for collections]]</td>
	<td>For tips on using collections.</td></tr>		<td>For tips on using collections.</td></tr>
	</table>		</table>

	[[Category:System classes]]		[[Category:System classes]]

JAL at 18:03, 13 November 2012

2012-11-13T18:03:26Z

← Older revision		Revision as of 18:03, 13 November 2012
Line 1:		Line 1:
	<!-- NamedArraylist class -->		<!-- NamedArraylist class -->
	<var>~~NamedArraylists~~</var> can be thought of as traditional ~~arrays~~ with no bounds but		A <var>NamedArraylist</var> can be thought of as a traditional array with no bounds but
	with identifying subscripts that can be arbitrary strings rather than numbers.		with identifying subscripts that can be arbitrary strings rather than numbers.

JAL: /* Examples */

2012-11-12T22:16:24Z

Examples

← Older revision		Revision as of 22:16, 12 November 2012
Line 8:		Line 8:
	<div id="NamedArraylist examples"><!--in case references to old section name-->		<div id="NamedArraylist examples"><!--in case references to old section name-->
	==Examples==		==Examples==
	The following code ~~illustrates~~ some of the <var>NamedArraylist</var> methods:		The following code shows some of the <var>NamedArraylist</var> methods:
	<p class="code">%narl is collection NamedArraylist of longstring		<p class="code">%narl is collection NamedArraylist of longstring
	%i is float		%i is float
Line 81:		Line 81:
	should be used wherever their functionality may		should be used wherever their functionality may
	prove useful, without concern for performance (which will be quite good).		prove useful, without concern for performance (which will be quite good).

	==List of NamedArraylist methods==		==List of NamedArraylist methods==
	The [[List of NamedArraylist methods\|"List of NamedArraylist methods"]] shows all the class methods, with a brief description of each.		The [[List of NamedArraylist methods\|"List of NamedArraylist methods"]] shows all the class methods, with a brief description of each.

Dme at 17:38, 3 August 2012

2012-08-03T17:38:41Z

← Older revision		Revision as of 17:38, 3 August 2012
Line 6:		Line 6:
	The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.		The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.

	==NamedArraylist examples==		<div id="NamedArraylist examples"><!--in case references to old section name-->
			==Examples==
	The following code illustrates some of the <var>NamedArraylist</var> methods:		The following code illustrates some of the <var>NamedArraylist</var> methods:
	<p class="code">%narl is collection NamedArraylist of longstring		<p class="code">%narl is collection NamedArraylist of longstring

JAL2 at 21:58, 23 December 2011

2011-12-23T21:58:03Z

← Older revision		Revision as of 21:58, 23 December 2011
Line 3:		Line 3:
	with identifying subscripts that can be arbitrary strings rather than numbers.		with identifying subscripts that can be arbitrary strings rather than numbers.

			==About the GenericNamedArraylist class==
	The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.		The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.

	~~For background information about collections and NamedArraylists and about~~		==NamedArraylist examples==
	~~declaring~~ NamedArraylist ~~object variables, see [[Collections]].~~		The following code illustrates some of the <var>NamedArraylist</var> methods:
	~~See also [[Collections#Coding considerations for collections\|Coding~~
	~~considerations for collections]].~~

	The following code illustrates some of the NamedArraylist methods:
	<p class="code">%narl is collection NamedArraylist of longstring		<p class="code">%narl is collection NamedArraylist of longstring
	%i is float		%i is float
Line 41:		Line 38:

	'''Note:''' The items are kept in EBCDIC order by their name.		'''Note:''' The items are kept in EBCDIC order by their name.
	This is always the case for NamedArraylist items.		This is always the case for <var>NamedArraylist</var> items.

	For another example, suppose there is a ~~recordSet (~~[[??]] ~~refid=filobj.)~~		For another example, suppose there is a <var>[[Recordset class\|Recordset]]</var> object
	in a file where		in a file where field <code>ProductId</code> has a product ID and field <code>Quantity</code> has the number
	field ProductId has a product ID and field Quantity has the number
	of items with that ID.		of items with that ID.
	The product IDs are ten-character alphanumeric IDs, so they cannot be used		The product IDs are ten-character alphanumeric IDs, so they cannot be used as numeric subscripts.
	as numeric subscripts.		Some records may have the same <code>ProductId</code> as others.
	Some records may have the same ProductId as others.

	NamedArraylists provide an ideal way of getting the total quantity		<var>NamedArraylists</var> provide an ideal way of getting the total quantity
	of each item in the ~~recordSet~~:		of each item in the <var>Recordset</var>:
	<p class="code">%quantity is collection NamedArraylist of float		<p class="code">%quantity is collection NamedArraylist of float
	...		...
Line 68:		Line 63:
	</p>		</p>

	Because UseDefault is set to <tt>True</tt>, the first reference to		Because <var>UseDefault</var> is set to <code>True</code>, the first reference to
	a %quantity item for a given ~~Productid~~ will return the default		a <code>%quantity</code> item for a given <code>ProductId</code> will return the default
	value of <tt>0</tt>.		value of <code>0</code>.
	The value of the Quantity field is added to this 0, and the		The value of the <code>Quantity</code> field is added to this 0, and the
	total is stored under the product ID.		total is stored under the product ID.
	Subsequent requests for the same product ID will return the		Subsequent requests for the same product ID will return the current running total for that product.
	current running total for that product.

	Looking up an item in a NamedArraylist by its name is only slightly		Looking up an item in a <var>NamedArraylist</var> by its name is only slightly
	(possibly immeasurably) more CPU intensive than looking up the		(possibly immeasurably) more CPU intensive than looking up the
	item by number, either in a NamedArraylist or in an Arraylist.		item by number, either in a <var>NamedArraylist</var> or in an <var>Arraylist</var>.
	NamedArraylist items will also take up a bit more space in CCATEMP		<var>NamedArraylist</var> items will also take up a bit more space in CCATEMP
	than Arraylist items — the extra space required to hold		than <var>Arraylist</var> items — the extra space required to hold the names.
	the names.
	Usually, this overhead should be minor.		Usually, this overhead should be minor.

	Because of their relatively low extra overhead, NamedArraylists		Because of their relatively low extra overhead, <var>NamedArraylists</var>
	should be used wherever their functionality may		should be used wherever their functionality may
	prove useful, without concern for performance (which will be quite good).		prove useful, without concern for performance (which will be quite good).

JAL2 at 21:44, 23 December 2011

2011-12-23T21:44:48Z

← Older revision		Revision as of 21:44, 23 December 2011
Line 6:		Line 6:

	For background information about collections and NamedArraylists and about		For background information about collections and NamedArraylists and about
	declaring NamedArraylist object variables,		declaring NamedArraylist object variables, see [[Collections]].
	see [[Collections]].
	See also [[Collections#Coding considerations for collections\|Coding		See also [[Collections#Coding considerations for collections\|Coding
	considerations for collections]].		considerations for collections]].

	The following code illustrates some of the NamedArraylist methods:		The following code illustrates some of the NamedArraylist methods:
	<~~pre style~~="~~xmp~~">		<p class="code">%narl is collection NamedArraylist of longstring
	%narl is collection NamedArraylist of longstring		%i is float
	%i is float

	%narl = new		%narl = new
	%narl:useDefault = true		%narl:useDefault = true
	%narl('Idle') = 'Eric'		%narl('Idle') = 'Eric'
	%narl('Cleese') = 'John'		%narl('Cleese') = 'John'
	%narl('Gilliam') = 'Terry'		%narl('Gilliam') = 'Terry'
	%narl('Pallin') = 'Michael'		%narl('Pallin') = 'Michael'
	%narl('Chapman') = 'Graham'		%narl('Chapman') = 'Graham'

	Print 'The American''s first name is ' %narl('Gilliam')		Print 'The American''s first name is ' %narl('Gilliam')

	print '*** Completely different:'		print '*** Completely different:'
	for %i from 1 to %narl:count		for %i from 1 to %narl:count
	print %narl:itemByNumber(%i) and %narl:nameByNumber(%i)		print %narl:itemByNumber(%i) and %narl:nameByNumber(%i)
	end for		end for
	</~~pre~~>		</p>

	This code prints:		This code prints:
	<~~pre style~~="~~xmp~~">		<p class="output">The American's first name is Terry
	The American's first name is Terry		*** Completely different:
	*** Completely different:		Graham Chapman
	Graham Chapman		John Cleese
	John Cleese		Terry Gilliam
	Terry Gilliam		Eric Idle
	Eric Idle		Michael Pallin
	Michael Pallin		</p>
	</~~pre~~>
	:~~Note.~~		'''Note:''' The items are kept in EBCDIC order by their name.
	The items are kept in EBCDIC order by their name.
	This is always the case for NamedArraylist items.		This is always the case for NamedArraylist items.

Line 56:		Line 53:
	NamedArraylists provide an ideal way of getting the total quantity		NamedArraylists provide an ideal way of getting the total quantity
	of each item in the recordSet:		of each item in the recordSet:
	<~~pre style~~="~~xmp~~">		<p class="code">%quantity is collection NamedArraylist of float
	%quantity is collection NamedArraylist of float		...
	...		%quantity = new
	%quantity = new		%quantity:useDefault = true
	%quantity:useDefault = true

	for each record in %recset		for each record in %recset
	%quantity(productId) = %quantity(productId) + quantity		%quantity(productId) = %quantity(productId) + quantity
	end for		end for

	for %i from 1 to %quantity:count		for %i from 1 to %quantity:count
	print %quantity:nameByNumber(%i) and -		print %quantity:nameByNumber(%i) and -
	%quantity:itemByNumber(%i)		%quantity:itemByNumber(%i)
	end for		end for
	</~~pre~~>		</p>

	Because UseDefault is set to <tt>True</tt>, the first reference to		Because UseDefault is set to <tt>True</tt>, the first reference to
	a %quantity item for a given Productid will return the default		a %quantity item for a given Productid will return the default
Line 91:		Line 88:
	prove useful, without concern for performance (which will be quite good).		prove useful, without concern for performance (which will be quite good).

	~~The individual~~ NamedArraylist methods ~~are described in the following subsections.~~		==List of NamedArraylist methods==
	~~In the method templates, <tt>%namrayl</tt> is used to represent the object~~		The [[List of NamedArraylist methods\|"List of NamedArraylist methods"]] shows all the class methods, with a brief description of each.
	~~to which the method is being applied, sometimes called the “method~~
	~~object”~~
	~~or the “method NamedArraylist.”~~
	~~Additional conventions are described in~~ [[~~Notation conventions for~~ methods]].
	==See also==		==See also==
	<table>		<table>
	~~<tr><th>[[List of NamedArraylist methods]]</th>~~
	~~<td>For a list of all methods in the <var>NamedArraylist</var> class, with a brief description of each.</td></tr>~~
	<tr><th>[[List of FloatNamedArraylist methods]]</th>		<tr><th>[[List of FloatNamedArraylist methods]]</th>
	<td>For a list of all methods in the <var>FloatNamedArraylist</var> class, with a brief description of each.</td></tr>		<td>For a list of all methods in the <var>FloatNamedArraylist</var> class, with a brief description of each.</td></tr>
Line 112:		Line 104:
	<td>For tips on using collections.</td></tr>		<td>For tips on using collections.</td></tr>
	</table>		</table>

	[[Category:System classes]]		[[Category:System classes]]

Alex at 20:46, 28 January 2011

2011-01-28T20:46:59Z

← Older revision		Revision as of 20:46, 28 January 2011
Line 3:		Line 3:
	with identifying subscripts that can be arbitrary strings rather than numbers.		with identifying subscripts that can be arbitrary strings rather than numbers.

	The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class.		The <var>NamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>NamedArraylist</var> class are documented as belonging to the <var>GenericNamedArraylist</var> class. Any method available in the <var>GenericNamedArraylist</var> class is also available in the <var>NamedArraylist</var> class. The other classes that extend the <var>GenericNamedArraylist</var> class are the <var>[[FloatNamedArraylist class\|FloatNamedArraylist]]</var> class and the <var>[[UnicodeNamedArraylist class\|UnicodeNamedArraylist]]</var> class.

	For background information about collections and NamedArraylists and about		For background information about collections and NamedArraylists and about

Alex at 20:33, 28 January 2011

2011-01-28T20:33:11Z

@@ Line 97: / Line 97: @@
 or the &ldquo;method NamedArraylist.&rdquo;
 Additional conventions are described in [[Notation conventions for methods]].
 [[Category:System classes]]