debian man page for 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 Universite 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)