doc/lfun/PreventInsert

PreventInsert()

FUNKTION:
     int PreventInsert(object ob);

DEFINIERT IN:
     /std/container/restrictions.c

ARGUMENTE:
     ob
          Das Objekt, das in den Behaelter eingefuegt werden soll.

BESCHREIBUNG:
     Mit dieser Funktion kann ein Behaelter pruefen, ob er das Objekt ob
     aufnehmen moechte oder nicht.

RUeCKGABEWERT:
     0, wenn das Objekt aufgenommen werden kann; ein Wert groesser als 0
     zeigt an, dass das Objekt nicht aufgenommen werden soll.

BEMERKUNGEN:
     Wenn ob mit dem Flag M_NOCHECK bewegt wird, wird PreventInsert() zwar
     aufgerufen, das Objekt wird jedoch auf jeden Fall in den Behaelter
     bewegt, unabhaengig vom Rueckgabewert!

BEISPIELE:
     Um zu verhindern, dass man Geld in einen Behaelter stecken kann, sollte
     man wie folgt vorgehen:

     varargs int PreventInsert(object ob)
     {
       // Wenn es Geld ist, erheben wir sofort Einspruch
       if (ob->id("geld"))
         return 1;
       // Ansonsten koennte ein ererbtes Objekt noch Einspruch erheben!
       else
         return ::PreventInsert(ob);
     }

SIEHE AUCH:
     PreventLeave(), NotifyInsert(), NotifyLeave(), MayAddObject(),
     PreventInsertLiving(), PreventLeaveLiving(), NotifyMove(),
     PreventMove(), MayAddWeight(), move(), /std/container/restrictions.c

----------------------------------------------------------------------------
Last modified: Sat Dec 18 02:00:00 1999 by Tiamak