delloins.3alc man page

delloins — delete a logical instance

Synopsis

#include "mlo.h"
int delloins(ptfig, insname)
lofig_list ∗ptfig;
char ∗insname;

Parameters

ptfig

Pointer to the figure in which the instance should be deleted

insname

Name of the instance to be deleted.

Description

delloins delete the instance called insname in the figure  pointed to by ptfig. This instance is warrantied to be unique, because its name is an identifier at the given hierarchical level. The list consistency is maintainded, and the space freed. The instance connectors are also freed, since if the instance disappear, no more connections can occur on it.

Return Value

delloins returns 1 if the instance has been deleted, 0 if no such instance exists in the list.

Example

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

See Also

mbk(1), lofig(3), loins(3), addloins(3), getloins(3).

Referenced By

addloins.3alc(3), getloins.3alc(3), loins.3alc(3), unflattenlofig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK LOGICAL FUNCTIONS