next up previous contents index
Next: GL_GETLATEST(lblmapfn,extra) Up: Administration Functions Previous: UBL_UNBINDLABEL(lbl)

GVS_GETVERSIONS(lbl,mapfn,extra)

     

Applies (*mapfn) to all items (versions) in the given object's history. For each item we have three slots and (*mapfn) is called on each slot in turn and given the corresponding labels. The slots (in call order) are:

  1. the actual version of the object,   
  2. the command historygif version for the store of the actual version (first item above),   
  3. the temporal predecessors of the actual version (first item above).   

The call format is:

(*mapfn)(extra,item,count)

where the arguments have the following declarations and contents:

Initialisation calls are done with a call to (*mapfn) with a NULL item and a zero `count'. The mapping function can return:

The store command label is omitted from the transient slots, but an extra case 2 call is inserted with a (label *)0 pointer; if the store command label values coincide with the version concerned, then the command label is in reality unknown and therefore the 2 call case is done with a (label *)0 pointer.

See section 10 for an example of using a mapfn.

Function returns:



next up previous contents index
Next: GL_GETLATEST(lblmapfn,extra) Up: Administration Functions Previous: UBL_UNBINDLABEL(lbl)



Martin Sjolin
Thu Jun 15 20:41:59 MET DST 1995