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

  
 
  

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

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

SYNOPSIS
     #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 el-
     ements, 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)

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

home | help