Identifiers

Identifiers in the script provide the access to the value of an object or a local variable. In case of a structured value, it is possible to access whole value, row of 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:

Value identifier

Notes:

  • Only coloured boxes shows 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 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 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, ...
IC_HOBJ_EXPR 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)
IC_VOBJ_EXPR Three comma-separated expressions enclosed in brackets:
  1. unique identifier - expression of HOBJ type
  2. row number - expression of INT type
  3. column number - expression of 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 of a type other than Structured variable. Sec, SysTime, I/O tag, ...
IC_O_R Object of Structured variable type. SV.Structure
IC_O_R_R Row of object Structured variable type. If the index is 0, it means whole value analogous to IC_O_R. SV.Structure[2], SV.Structure[0]
IC_O_R_RIA Row item of object of Structured variable type. The item is Object type (reference to object). SV.Structure[2]^Object
IC_O_R_RIN Row item of object of Structured variable type. The item is not Object type (reference to object). SV.Structure[2]^Text
IC_L Local variable of BOOL, INT, TEXT, TIME or REAL types.  
IC_L_CONST Constant (initialized) local variable of BOOL, INT, TEXT, TIME or REAL type.  
IC_L_AN Local variable of ALIAS type (untyped). ALIAS _a
IC_L_AT Local variable of typed ALIAS type (without index or access to item). ALIAS (SD.RecordDef) _recA
IC_L_AT_R Row of object of Structured variable type, to which the typed ALIAS currently refers. If the index is 0, it means whole value. _recA[1] or the whole value
_recA[0]
IC_L_AT_RIA Row item of an object of Structured variable type, to which the typed ALIAS currently refers. The item is Object type (reference to object). _recA[1]^Object
IC_L_AT_RIN Row item of an object of Structured variable type, to which the typed ALIAS currently refers. The item is not Object type (reference to object). _recA[1]^Text
IC_L_RNA Local variable of Record type. Reference to the whole value. RECORD NOALIAS (SD.RecordDef) _recNA
IC_L_RNA_R Local variable row of 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 item of a local variable of Record type. The item is Object type (reference to object). Considering forbidden references to objects, this item represents an simple value (without predefined value type). _recNA[1]^Object
IC_L_RNA_RIN Row item of a local variable of Record type. The item is Object type (reference to 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 of local variable of Record type. If the index is 0, it means whole value analogous to IC_L_R. _rec[1] or the whole value
_rec[0]
IC_L_R_RIA Row item of a local variable of Record type. The item is Object type (reference to object). _rec[1]^Object
IC_L_R_RIN Row item of a local variable of Record type. The item is not Object type (reference to object). _rec[1]^Text
IC_L_NR Local variable of 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 Record type (the structure type is not define). 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 variable of Record type (the structure type is not define). The column is defined by the number. _rec[1]^_iCol
IC_L_NRNA Local variable of Record type (the structure type is not define). The reference to the whole value. RECORD NOALIAS () _recNA
IC_L_NRNA_R The row of local variable of Record type (the structure type is not define). 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 variable of Record type (the structure type is not define). The column is defined by the number. _recNA[1]^_iCol

Related pages:

Script actions
Terms used to describe actions

Napíšte komentár