dellocap(3) delete a logical capacitor

SYNOPSYS

#include "mlo.h"
int dellocap(ptfig,ptcap)
lofig_list *ptfig ;
locap_list *ptcap ;

PARAMETERS

ptfig
Pointer to the figure in which the capacitor should be deleted
ptcap
Pointer to the capacitor to be deleted.

DESCRIPTION

dellocap delete the capacitor pointed to by ptcap in the figure pointed to by ptfig. The list consistency is maintainded, and the space freed. The capacitor connectors are also freed, since if the capacitor disapear, no more connections can occur on it.

RETURN VALUE

dellocap returns 1 if the capacitor has been deleted, 0 if the capacitor pointer does not exists in the list.

EXAMPLE

#include "mlo.h"
char *was_existing(lofig_list *ptfig,locap_list *ptcap)
{
  return dellocap(ptfig,ptcap) ? "you just killed it!" : "wasn't here anyway" ; 
}