Next: RFL_REMOVEFROMLATEST(lbl)
Up: Administration Functions
Previous: GVS_GETVERSIONS(lblmapfn,extra)

Calls (*mapfn) once for each member of the set of latest for the given
object. The call format is:
(*mapfn)(extra,item,count,length);
where the arguments have the following declarations and contents:
- void *extra is passed in to the LIBLINCKS function as
an extra application program parameter. It is not used within
LIBLINCKS, and is intended as a pointer to a call block for
application program arguments to the map function.
- char *item
points to a bound label placed in the internal label buffer.
- int count
contains the sequence number of the current member. The first member
has number one (1), the second has number two (2), and so on. This
enumeration is done every time GL_GETLATEST() is called.
- int length
contains the total number of members in latest. This number stays the
same over all calls to the map function.
The map function is first called with a NULL `item', and a zero
`count'. This call is intended for initialisation. The mapping
continues until the map function returns non zero, or there are no more
members.
See section 10 for an example of using
a mapfn.
Function returns:

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