debian man page for delnum

DELNUM(3)						       MBK UTILITY FUNCTIONS							 DELNUM(3)

NAME
       delnum - delete an element of a num_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 *delnum(pthead, ptdel)
       num_list *pthead, *ptdel;

PARAMETERS
       pthead		   Pointer to a num list

       ptdel		   Pointer to the element to be deleted.

DESCRIPTION
       delnum deletes the element of the num_list pointed to by ptdel in the list pointed to by pthead.  The list consistency is maintainded,  and
       the element put back in the list of free blocks.

RETURN VALUE
       delnum returns a pointer to the new head of list if the ptdel pointer used to belong to the list. In most case, it has the value of pthead.
       If the pointer doesn't belong to the list, NULL is returned.

ERROR
       "*** mbk error *** delnum impossible : pointer NULL"
	      At least one of the arguments are pointing to NULL, and that clear that such a pointer can't be deleted.

EXAMPLE
       #include "mut.h"
       void delete_match(c0, c1)
       num_list *c1, *c2;
       {
       num_list *t0, *t1, *next;
	  for (t0 = c0; t0; t0 = next)
	     for (t1 = c1; t1; t1 = t1->NEXT)
		if (t1->DATA == t0->DATA)
		   next = delnum(c0, t0);
       }

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