NAME¶

addchain - create a chain 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"
chain_list ∗addchain(pthead, ptdata)
chain_list ∗pthead;
void ∗ptdata;

PARAMETERS¶

pthead

Pointer to a chain_list

ptdata

Generic pointer to any kind of information

DESCRIPTION¶

addchain creates a new chain element and adds it to the front of the list pointed to by pthead, and becomes itself the list head. The chain_lists are mosty used to create temporary lists of homogeneous elements, for binary trees, and so on. The ptdata points to any kind of list or may itself be a value, if proper cast is performed at compilation time, and fills the DATA field of the chain structure. For details on the structure, see chain(3).

RETURN VALUE¶

addchain returns a pointer to the new head of list.

EXAMPLE¶

#include "mut.h"
#include "mlo.h"
chain_list ∗get_external_connectors(ptfig)
lofig_list ∗ptfig;
{
locon_list ∗pt = ptfig->LOCON;
chain_list ∗c = NULL; /∗ initialized for regularity ∗/
	while (pt) {
		if (pt->TYPE == EXTERNAL)
			c = addchain(c, (void ∗)pt)
		pt = pt->NEXT;
	}	
	return c;
}	

SEE ALSO¶

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