FloatNamedArraylist class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 60: Line 60:
or the “method FloatNamedArraylist.”
or the “method FloatNamedArraylist.”
Additional conventions are described in [[Notation conventions for methods]].
Additional conventions are described in [[Notation conventions for methods]].
==See also==
<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>
<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>
<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>
<td>For background information about collections and <var>Arraylist</var>s and about
declaring <var>Arraylist</var> object variables.</td></tr>
<tr><th>[[Collections#Coding considerations for collections|Coding
considerations for collections]]</th>
<td>For tips on using collections.</td></tr>
</table>
[[Category:System classes]]
[[Category:System classes]]

Revision as of 20:50, 28 January 2011

The FloatNamedArraylist class is nearly identical to the NamedArraylist class. The significant difference is that instead of subscript names for items as in the NamedArraylist class, the item subscripts in a FloatNamedArraylist object are numeric values. These numeric subscripts are basically like the Model 204 Float datatype, and FloatNamedArraylist items are stored in numeric order by subscript, whereas NamedArraylist items are stored by item name in EBCDIC order.

The FloatNamedArraylist class extends the system GenericNamedArraylist class, so many of the methods available in the FloatNamedArraylist class are documented as belonging to theGenericNamedArraylist class. Any method available in the GenericNamedArraylist class is also available in the FloatNamedArraylist class. The other classes that extend the GenericNamedArraylistclass are the NamedArraylist class and the UnicodeNamedArraylist class.

For example, the following request demonstrates the numerically ordered result produced by a FloatNamedArraylist but not by a NamedArraylist:

    b
 
    %x  is collection namedArraylist of string len 32
    %y  is collection floatNamedArraylist of string len 32
    %i  is float
 
    %x = new
    %x(7) = 'seven'
    %x(38) = 'thirty-eight'
    %x(110) = 'one-hundred-ten'
 
    %y = new
    %y(7) = 'seven'
    %y(38) = 'thirty-eight'
    %y(110) = 'one-hundred-ten'
 
    for %i from 1 to %x:count
       print %x:nameByNumber(%i) and %x:itemByNumber(%i)
    end for
 
    for %i from 1 to %y:count
       print %y:nameByNumber(%i) and %y:itemByNumber(%i)
    end for
 
    end

The request prints:

    110 one-hundred-ten
    38 thirty-eight
    7 seven
    -----
    7 seven
    38 thirty-eight
    110 one-hundred-ten

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

The individual FloatNamedArraylist methods are described in the following subsections. In the method templates, %fnamrayl is used to represent the object to which the method is being applied, sometimes called the “method object” or the “method FloatNamedArraylist.” Additional conventions are described in Notation conventions for methods.

See also

List of NamedArraylist methods For a list of all methods in the NamedArraylist class, with a brief description of each.
List of FloatNamedArraylist methods For a list of all methods in the FloatNamedArraylist class, with a brief description of each.
List of UnicodeNamedArraylist methods For a list of all methods in the UnicodeNamedArraylist class, with a brief description of each.
Collections For background information about collections and Arraylists and about declaring Arraylist object variables.
Coding considerations for collections For tips on using collections.