addchain

ADDCHAIN(3)                  MBK UTILITY FUNCTIONS                 ADDCHAIN(3)



NAME
       addchain - create a chain and add it to a list


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


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).




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                    ADDCHAIN(3)