append(3) [debian man page]

APPEND(3)						       MBK UTILITY FUNCTIONS							 APPEND(3)

NAME

       append - append a chain_list to an other chain_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"
       chain_list *append(pt1, pt2)
       chain_list *pt1,*pt2;

PARAMETERS

       pt1		   Pointer to a chain_list

       pt2		   Pointer to a chain_list

DESCRIPTION

       append appends the contains of the chain_list pointed to by pt2 at the end of the one pointed to by pt1.
       The lists consistency is warranted by the use of the adequat add functions.

RETURN VALUE

       append returns a pointer to the new head of list.  If pt1 is not NULL, it has the value of pt1, else it is pt2.

EXAMPLE

       #include "mut.h"
       #include "mlo.h"
       void sig_names(s0, s1)
       losig_list *s0, *s1;
       {
	  s0->NAMECHAIN = append(s0->NAMECHAIN, s1->NAMECHAIN);
       }

SEE ALSO

       mbk(1), chain(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							 APPEND(3)

DELCHAIN(3)						       MBK UTILITY FUNCTIONS						       DELCHAIN(3)

NAME

       delchain - delete an element of a chain_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"
       chain_list *delchain(pthead, ptdel)
       chain_list *pthead;
       chain_list *ptdel;

PARAMETERS

       pthead		   Pointer to a chain list

       ptdel		   Pointer to the element to be deleted.

DESCRIPTION

       delchain deletes the element of the chain_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

       delchain  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 *** delchain impossible : pointer NULL"
	      At least one of the arguments are pointing to NULL, and that clear that such a pointer can't be deleted, or used for freeing.

EXAMPLE

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

SEE ALSO

       mbk(1), chain(3), addchain(3), freechain(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						       DELCHAIN(3)