Scroll to navigation

ADDCHAIN(3) MBK UTILITY FUNCTIONS ADDCHAIN(3)

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.

October 1, 1997 ASIM/LIP6