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

FreeBSD Manual Pages

  
 
  

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

NAME
       delnum -	delete an element of a num_list

SYNOPSYS
       #include	"mut.h"
       num_list	*delnum(pthead,	ptdel)
       num_list	*pthead, *ptdel;

PARAMETERS
       pthead		   Pointer to a	num list

       ptdel		   Pointer to the element to be	deleted.

DESCRIPTION
       delnum  deletes	the element of the num_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
       delnum  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 *** delnum impossible : pointer NULL"
	      At  least	 one  of  the arguments	are pointing to	NULL, and that
	      clear that such a	pointer	can't be deleted.

EXAMPLE
       #include	"mut.h"
       void delete_match(c0, c1)
       num_list	*c1, *c2;
       {
       num_list	*t0, *t1, *next;
	  for (t0 = c0;	t0; t0 = next)
	     for (t1 = c1; t1; t1 = t1->NEXT)
		if (t1->DATA ==	t0->DATA)
		   next	= delnum(c0, t0);
       }

SEE ALSO
       mbk(1), num(3), addnum(3), freenum(3).

ASIM/LIP6			October	1, 1997			     DELNUM(3)

NAME | SYNOPSYS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERROR | EXAMPLE | SEE ALSO

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

home | help