addnum

ADDNUM(3)                    MBK UTILITY FUNCTIONS                   ADDNUM(3)



NAME
       addnum - create a num 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"
       num_list ∗addnum(ptnum, data)
       num_list ∗ptnum;
       long data;

PARAMETERS
       ptnum               Pointer to a num_list

       data                Value of the data

DESCRIPTION
       addnum creates a new num element and adds it to the front of the list
       pointed to by ptnum, and becomes itself the list head.
       The data fills the DATA field of the num strucutre.  For details on the
       structure, see num(3).

RETURN VALUE
       addnum returns a pointer to the new head of list.

EXAMPLE
       #include "mut.h"
       #include "mlo.h"
       void count(pn)
       num_list ∗pn;
       {
       num_list ∗c = NULL; /∗ initialized for regularity ∗/
          while (pt) {
             if (pt->TYPE == EXTERNAL)
                c = addnum(c, (void ∗)pt)
             pt = pt->NEXT;
          }
          return c;
       }

SEE ALSO
       mbk(1), num(3), freenum(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                      ADDNUM(3)