GETCOLTIME action

Function

The action retrieves the values' times in given column of structured local variable (i.e. local variable of Record type).

Declaration

GETCOLTIME _srcRec^Col, _dstRec^DateTimeCol

Parameters

_srcRec	in	Row identifier of local variable of Record type - source column used to acquire times of individual values.
_dstRec	out	Row identifier of local variable of Record type - target column used to write the times in.

Description

For each item in the column DateTimeCol of the structure _dstRec, the action sets a value of Absolute time type, which represents a time of the value occurrence in corresponding row and given column of the structure _srcRec. There must be the same number of rows in both the structures.

The action represents a substitution of the following loop:

RECORD (SD.Def) _srcRec
 RECORD (SD.Def) _dstRec
 
 BEGIN
   REDIM _srcRec[10]
   REDIM _dstRec[10]
 
 
 ; Execution of the action GETCOLTIME
   IF _srcRec\DIM # _dstRec\DIM THEN
     ; The error_ERR_RANGE_ERROR
     END
   ENDIF
 
   INT _row
   _row := 1
   DO_LOOP
     EXIT_LOOP _row > _srcRec\DIM
     _dstRec[_row]^DateTimeCol := _srcRec[_row]^Col\TIM
     _row := _row + 1
   END_LOOP
 ; Action end
 
 END

The column DateTimeCol used in the example must be of Absolute time type.

Example

The following example executes the loop described above using the action GETCOLTIME .

GETCOLTIME _srcRec^Col, _dstRec^DateTimeCol

Related pages:

Script actions