I.4.10 “getData”

The getData method returns an Array of Arrays containing the data stored in a Result object. The returned Array may actually be considered as a two-dimensional Array with as many lines as there are pairs of key-value in the Result object. Each line of the Array contains 6, 8 or 11 elements:

1.

The first element corresponds to the elemId.

2.

The second element corresponds to the nodeId of the key.

3.

The third element corresponds to the layerId of the key.

4.

The fourth element corresponds to the subLayerId of the key.

5.

The fifth element corresponds to the coordinate system in which the value components are associated. The possible values are summarized in Table I.4.9.

6.

The other elements are real values corresponding to the components (1, 3 or 6 values for a scalar, vectorial or tensorial Result respectively). For the precise meaning of the returned value corresponding to coordinate system, see also section I.4.1.2.

The method may have 5, 4, 3, 2, 1 or no argument. The arguments correspond to the type of the Array elements corresponding to elemId, nodeId, layerId, subLayerId or coordSysId. In the returned Array, these elements may be of String or Integer types. Correspondingly the arguments are Strings the value of which can be "int", "string" or any other String. If any other String is used as argument (for example a void string), the default Integer or String type elements are returned.

For element, node and layer ids, the negative values correspond to “special” values. (See Tables I.4.2 to I.4.4.)