A ResKeyList object is basically a set of Result keys (see Chapter I.4). Actually, a ResKeyList object is a kind of Result with no values associated to the keys.
One shows in section I.4.2 that several methods of class Result allow to build ResKeyList objects from Results, and to extract Results from other Results using ResKeyList objects.
A list of the methods defined in ``ResKeyList'' class is given in Table I.5.1.
|(FeResPost list of classes is given in Table 1 page .)|
|Creation and initialization|
|Layers and sub-layers manipulation|
The usual ``RKL.newnew'' and ``RKL.initializeinitialize'' singleton methods are defined in the ResKeyList class. These methods have no arguments. The class member method ``RKL.cloneclone'' has no argument and returns a copy of the object.
The user can fill its one ResKeyList object with the ``RKL.insertinsert'' method. This method takes one Array Argument with between 1 and 4 elements corresponding to the element identifier, the node identifier, the layer identifier and the sub-layer identifier. Each element can be a String or an integer.
Two extraction functions have been defined:
The two methods described below correspond with the methods with identical names defined in ``Result'' class.
``renumberLayers'' is a method used to renumber the layer integer ids of ResKeyList keys. The method has one Hash argument corresponding to the pairs of ``old integers IDs'' and ``new integer IDs''.
``renumberSubLayers'' is a method used to renumber the sub-layer integer ids of ResKeyList keys. The method has one Hash argument corresponding to the pairs of ``old integers IDs'' and ``new integer IDs''.
``removeLayers'' is a method used to remove keys selected on the basis of the layer ID of the key. The method has one ``LayersList'' argument: it is an Array containing the list of layers for which the keys must be removed. The elements of the Array argument are integer or String values.
``removeSubLayers'' is a method used to remove keys selected on the basis of the layer ID of the key. The method has one ``SubLayersList'' argument: it is an Array containing the list of sub-layers for which the keys must be removed. The elements of the Array argument are integer or String values.
Eight such operators have been defined. One first explains the meaning and behavior of the four elementary dyadic operations.
One ``RKL.each_keyeach_key'' iterator is defined in the class: it iterates on the data and produces Arrays of three elements corresponding to keys. The iterator may have between 0 and 4 arguments argument. The arguments are Strings that specify whether some of the data are to be returned in String or integer format.
Actually, the ``RKL.each_keyeach_key'' iterator of ResKeyList class is identical to the ``Result.each_keyeach_key'' iterator of Result class.
The method returns an Array of Arrays containing the data stored in a ResKeyList object. The returned Array may actually be considered as a two-dimensional Array with as many lines as there are pairs of keys in the ResKeyList object. Each line of the Array contains four elements:
Actually, this method corresponds to the ``Result.getDatagetData'' method of Result class (See section I.4.9). The special key names are the same as those listed in Tables I.4.2 to I.4.4.
One gives here a list of methods that do not fit in any category listed above: