addchain.3alc - Man Page
create a chain and add it to a list
Synopsis
#include "mut.h" chain_list ∗addchain(pthead, ptdata) chain_list ∗pthead; void ∗ptdata;
Parameters
- pthead
Pointer to a chain_list
- ptdata
Generic pointer to any kind of information
Description
addchain creates a new chain element and adds it to the front of the list pointed to by pthead, and becomes itself the list head.
The chain_lists are mosty used to create temporary lists of homogeneous elements, for binary trees, and so on.
The ptdata points to any kind of list or may itself be a value, if proper cast is performed at compilation time, and fills the DATA field of the chain structure. For details on the structure, see chain(3).
Return Value
addchain returns a pointer to the new head of list.
Example
#include "mut.h" #include "mlo.h" chain_list ∗get_external_connectors(ptfig) lofig_list ∗ptfig; { locon_list ∗pt = ptfig->LOCON; chain_list ∗c = NULL; /∗ initialized for regularity ∗/ while (pt) { if (pt->TYPE == EXTERNAL) c = addchain(c, (void ∗)pt) pt = pt->NEXT; } return c; }
See Also
mbk(1), chain(3), freechain(3), delchain(3).
Referenced By
chain.3alc(3), delchain.3alc(3), freechain.3alc(3), unflattenlofig.3alc(3).
October 1, 1997 ASIM/LIP6 MBK UTILITY FUNCTIONS