...
Identifiers in the script provide the access to the value of an object or a local variable. In the case of a structured value, it is possible to access the whole value, the row of a structured variable or its item by through an identifier.
The following figure shows and names all possible methods of the reference to a value, which are used in ESL:
Image Modified
Notes:
- Only coloured boxes shows show a value.
- A green-coloured box represents a value (group of values in case of a structure), with no references to other objects (ALIAS or column of the Object type).
- A red-coloured box represents a value (group of values in case of a structure), with references to other objects (ALIAS or column of the Object type).
- A combination of red and green colours represents a value (group of values in case of a structure) where values and references may be combined.
- Each method of reference to value is named (red text above box).
Examples for individual types of references to value:| Reference type (name) | Value description | Example |
|---|
| IC_C | Constant. | "Text", 1, ... |
| Expression of INT type that is interpreted as the reference to an object. The object is enclosed in brackets on the position where the identifier is expected. | (20), (Sec\HBJ) |
| Three comma-separated expressions enclosed in brackets:- unique identifier - expression of HOBJ type
- row number - an expression of the INT type
- column number - an expression of the INT type
Note: The reference may only be used as a reference to a historical value for the GETARCHVAL, GETARCHARR a SETDT_LINEOBJ actions. | (H.Struct\HBJ, 2, 3) |
| IC_O |
Object Object Row Row object Row object |
|
| IC_L_CONST | Constant (initialized) local variable of BOOL, INT, TEXT, TIME or REAL type. |
Local variable | A local variable of ALIAS type (untyped). | ALIAS _a |
| IC_L_AT |
Local variable | A local variable of typed ALIAS type (without index or access to item). | ALIAS (SD.RecordDef) _recA |
| IC_L_AT_R |
Row object | objects of the Structured variable type, to which the typed ALIAS currently refers. If the index is 0, it means the whole value. | _recA[1] or the whole value
_recA[0] |
| IC_L_AT_RIA |
Row | The row item of an object of Structured variable type, to which the typed ALIAS currently refers. The item is Object type (a reference to an object). | _recA[1]^Object |
| IC_L_AT_RIN |
Row | The row item of an object of Structured variable type, to which the typed ALIAS currently refers. The item is not an Object type (a reference to an object). | _recA[1]^Text |
| IC_L_RNA |
Local variable of | A local variable of the Record type. Reference to the whole value. | RECORD NOALIAS (SD.RecordDef) _recNA |
| IC_L_RNA_R |
Local variable | A local variable row of the Record type. If the index is 0, it means whole value similarly to IC_L_RNA. | _recNA[1] or the whole value _recNA[0] |
| IC_L_RNA_RIA |
Row | The row item of a local variable of Record type. The item is Object type (a reference to an object). Considering forbidden references to objects, |
this an | a simple value (without predefined value type). | _recNA[1]^Object |
| IC_L_RNA_RIN |
Row | The row item of a local variable of Record type. The item is Object type (a reference to an object). Unlike IC_L_RNA_RIA, the value type of the item is defined. | _recNA[1]^Text |
| IC_L_R | A local structured variable. Reference to the whole value. | RECORD (SD.RecordDef) _rec |
| IC_L_R_R |
Row variable| variables of the Record type. If the index is 0, it means the whole value analogous to IC_L_R. | _rec[1] or the whole value
_rec[0] |
| IC_L_R_RIA |
Row | The row item of a local variable of the Record type. The item is Object type (a reference to an object). | _rec[1]^Object |
| IC_L_R_RIN |
Row | The row item of a local variable of the Record type. The item is not Object type (a reference to an object). | _rec[1]^Text |
| IC_L_NR |
Local variable of Record | A local variable of the Record type (the structure type is not defined). The reference to the whole value. | RECORD () _rec |
| IC_L_NR_R | The row of local variable |
of | s of the Record type (the structure type is not |
define| defined). If the index is 0, it is the whole value like IC_L_NR. | _rec[1] or the whole value
_rec[0] |
| IC_L_NR_RII | The row item of local variables of the Record type (the structure type is not |
define| defined). The column is defined by the number. | _rec[1]^_iCol |
| IC_L_NRNA |
Local Record | the Record type (the structure type is not |
define| defined). The reference to the whole value. | RECORD NOALIAS () _recNA |
| IC_L_NRNA_R | The row |
of of | s of the Record type (the structure type is not |
define| defined). If the index is 0, it is the whole value like IC_L_NRNA. | _recNA[1] or the whole value
_recNA[0] |
| IC_L_NRNA_RII | The row item of local variables of the Record type (the structure type is not define). The column is defined by the number. | _recNA[1]^_iCol |
...