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 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 ∗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"

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.