Calls (*mapfn) once for each entry in the link value of the given field in the specified group in the link section of the given version. The call format is:
(*mapfn)(extra,item,count,length);
where the arguments have the following declarations and contents:
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.
points to the label placed in the internal label buffer.
contains the sequence number of the current entry. The first entry has number one (1), the second has number two (2), and so on. This enumeration is done every time GLV_GETLINKVAL() is called.
contains the number of entries in the link value. 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 fields.
See section 10 for an example of using a mapfn.
Function returns: