addchain

Langue: en

Version: October 1, 1997 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

addchain - create a chain and add it to a list
man2html: unable to open or read file man1/alc_origin.1

SYNOPSYS

 #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).
man2html: unable to open or read file man1/alc_bug_report.1