SMC_GetObjFromHistory (FUN)

 

FUNCTION SMC_GetObjFromHistory : POINTER TO SMC_GEOINFO

Returns an object that has been deleted but not yet overwritten. For N >= 0, SMC_GetObjFromHistory(poq, N) = SMC_GetObj(poq, N). For negative N, the objects from the history are retrieved. (N=-1 gets the newest object from history, smaller N get older elements). The valid range for N is -SMC_GetHistoryCount(poq) ... SMC_GetCount(poq) - 1.

Note

This function should only be used from the task that is reading and deleting elements from the queue.

InOut:

Scope

Name

Type

Comment

Return

SMC_GetObjFromHistory

POINTER TO SMC_GEOINFO

Input

poq

POINTER TO SMC_OUTQUEUE

The out queue

N

DINT

Index of the object, counting is started with N=0