UnicodeNamedArraylist class - Revision history

JAL: /* About the GenericNamedArraylist class */

2012-11-13T18:12:20Z

About the GenericNamedArraylist class

← Older revision		Revision as of 18:12, 13 November 2012
Line 7:		Line 7:

	==About the GenericNamedArraylist class==		==About the GenericNamedArraylist class==
	The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.		The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.

	==Examples==		==Examples==
	The following annotated request demonstrates the		The following annotated request demonstrates the

Dme at 19:06, 4 August 2012

2012-08-04T19:06:36Z

← Older revision		Revision as of 19:06, 4 August 2012
Line 9:		Line 9:
	The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.		The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.

	==Examples=		==Examples==
	The following annotated request demonstrates the		The following annotated request demonstrates the
	methods where the distinction between a <var>UnicodeNamedArraylist</var> and a <var>NamedArraylist</var> is significant.		methods where the distinction between a <var>UnicodeNamedArraylist</var> and a <var>NamedArraylist</var> is significant.

Dme: /* Example */

2012-08-04T19:06:11Z

Example

← Older revision		Revision as of 19:06, 4 August 2012
Line 9:		Line 9:
	The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.		The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.

	==~~Example=~~=		==Examples=
	The following annotated request demonstrates the		The following annotated request demonstrates the
	methods where the distinction between a <var>UnicodeNamedArraylist</var> and a <var>NamedArraylist</var> is significant.		methods where the distinction between a <var>UnicodeNamedArraylist</var> and a <var>NamedArraylist</var> is significant.
Line 81:		Line 81:
	6: Andromeda		6: Andromeda
	</p>		</p>

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

JAL2 at 22:24, 23 December 2011

2011-12-23T22:24:49Z

Show changes

Alex at 20:50, 28 January 2011

2011-01-28T20:50:38Z

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

Alex at 20:13, 28 January 2011

2011-01-28T20:13:19Z

← Older revision		Revision as of 20:13, 28 January 2011
Line 1:		Line 1:
	<!-- UnicodeNamedArraylist class -->		<!-- UnicodeNamedArraylist class -->
	The UnicodeNamedArraylist class is nearly identical to the NamedArraylist class.		The <var>UnicodeNamedArraylist</var> class is nearly identical to the <var>[[NamedArraylist class\|NamedArraylist]]</var> class. The main difference is that instead of EBCDIC subscript names for items as in the <var>NamedArraylist</var> class, the name subscripts in a <var>UnicodeNamedArraylist</var> object are Unicode values. <var>UnicodeNamedArraylist</var> items are stored by item name in Unicode order, whereas <var>NamedArraylist</var> items are stored by item name in EBCDIC order.
	The main difference is that instead of EBCDIC subscript names for items as in
	the NamedArraylist class, the name subscripts in a UnicodeNamedArraylist object are		The <var>UnicodeNamedArraylist</var> class extends the system <var>[[GenericNamedArraylist class\|GenericNamedArraylist]]</var> class, so many of the methods available in the <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var> class.
	Unicode values.
	UnicodeNamedArraylist items are stored by item name in Unicode order,
	whereas NamedArraylist items are stored by item name in EBCDIC order.

	UnicodeNamedArraylists were added in ''Sirius Mods'' version 7.6.		UnicodeNamedArraylists were added in ''Sirius Mods'' version 7.6.

Dme: Created page with " The UnicodeNamedArraylist class is nearly identical to the NamedArraylist class. The main difference is that instead of EBCDIC subscript name..."

2011-01-04T21:28:19Z

Created page with " The UnicodeNamedArraylist class is nearly identical to the NamedArraylist class. The main difference is that instead of EBCDIC subscript name..."

New page

The UnicodeNamedArraylist class is nearly identical to the NamedArraylist class.
The main difference is that instead of EBCDIC subscript names for items as in
the NamedArraylist class, the name subscripts in a UnicodeNamedArraylist object are
Unicode values.
UnicodeNamedArraylist items are stored by item name in Unicode order,
whereas NamedArraylist items are stored by item name in EBCDIC order.

UnicodeNamedArraylists were added in ''Sirius Mods'' version 7.6.
'''Note:'''
The names of UnicodeNamedArraylists are limited to 127 characters (versus
255 bytes for NamedArraylists).

The following annotated request demonstrates the
methods where the distinction between a UnicodeNamedArraylist
and a NamedArraylist is significant.
The [[U (String function)|U]] constant function handily creates Unicode strings
in the item name subscripts.
Those names also begin with an
XHTML entity reference, which is further discussed [[??]] reftxt=* refid=entrefs..

b

%i is float
%k is unicodeNamedArraylist of longstring
%m is Arraylist of longstring
%k = new

'''* implicit Item method sets list item values:'''
%k('&sect;Jan':u) = 'Orion'
%k('&sect;Apr':u) = 'Leo'
%k('&sect;Mar':u) = 'Cancer'
%k('&sect;Jun':u) = 'Ursa Minor'
%k('&sect;Nov':u) = 'Andromeda'
%k('&sect;Dec':u) = 'Aries'
%k('&sect;Feb':u) = 'Canis Major'

'''* print the value of the item whose name is the'''
'''* Item method argument:'''
print %k:Item('&sect;Jan':u)

'''* print item number of named item:'''
print %k:number('&sect;Nov':u)

'''* print name of each list item, in order of item position'''
'''* from first to last:'''
for %i from 1 to %k:count
print %i ': ' %k:nameByNumber(%i)
end for

'''* how many items remain after specified item is removed?'''
printText {~} = {%k:removeItem('&sect;Dec':u)}

'''* names and values of list items in order by item position:'''
for %i from 1 to %k:count
print %k:nameByNumber(%i) ': ' and %k:itembyNumber(%i)
end for

'''* sort list values alphabetically in descending order'''
%m = %k:sortNew(descending(this))
%m:print

end


The request prints:
<pre style="xmp">
Orion
7
1: &sect.Apr
2: &sect.Dec
3: &sect.Feb
4: &sect.Jan
5: &sect.Jun
6: &sect.Mar
7: &sect.Nov
%k:removeItem('&sect;Dec':u) = 6
&sect.Apr: Leo
&sect.Feb: Canis Major
&sect.Jan: Orion
&sect.Jun: Ursa Minor
&sect.Mar: Cancer
&sect.Nov: Andromeda
1: Ursa Minor
2: Orion
3: Leo
4: Canis Major
5: Cancer
6: Andromeda
</pre>

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

The individual UnicodeNamedArraylist methods are described in the following subsections.
In the method templates, <tt>%unamrayl</tt> is used to represent the object
to which the method is being applied, sometimes called the “method object”
or the “method UnicodeNamedArraylist.”
Additional conventions are described in [[Notation conventions for methods]].
[[Category:System classes]]