Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ADDCHAIN(3)		     MBK UTILITY FUNCTIONS		   ADDCHAIN(3)

NAME
       addchain	- create a chain and add it to a list

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).

ASIM/LIP6			October	1, 1997			   ADDCHAIN(3)
NAME | SYNOPSYS | PARAMETERS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=addchain&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help