NotifyDestruct()
****************


FUNKTION
========

   public int|string NotifyRemove(object zerstoerer);


ARGUMENTE
=========

   zerstoerer
        Das Objekt, welches destruct() auf dieses Objekt anwendet.


BESCHREIBUNG
============

   Diese Funktion wird vom Master der Mudlib in jedem Objekt gerufen,
   welches zerstoert wird, um Objekten eine letzte Chance zu geben, sich
   aufzuraeumen.
   Wenn ihr diese Funktion selber definiert, achtet bittet darauf, dass sie
   in keinem Fall Fehler ausloesen sollte, d.h. testet entsprechend
   gruendlich.
   Wenn ihr aus /std/ erbt und diese Funktion ueberschreibt,, _muesst_ ihr
   die geerbte NotifyDestruct() aufrufen, da sonst das Lichtsystem nicht
   aktualisiert wird.

   Privilegierte Objekte (z.B. Root-Objekte, spezielle Ausnahmen wie der
   Netztotenraum, Armageddon) koennen die Zerstoerung in letzter Sekunde
   verhindern, indem sie hier einen Wert != 0 zurueckliefern. Wird ein
   string zurueckgeliefert, wird dieser die Fehlermeldung des
   prepare_destruct() im Master sein.
   Bei nicht-privilegierten Objekten (also fast alle) ist an dieser Stelle
   _kein_ Abbruch der Zerstoerung moeglich!


RUeCKGABEWERT
=============

   Der Rueckgabewert muss ein string oder ein int sein. Allerdings wird der
   Master den Rueckgabewert nur fuer privilegierte Objekte auswerten.


BEMERKUNGEN
===========

   Wie gesagt, bitte keine Fehler ausloesen (auch wenn der Master
   grundsaetzlich damit klar kommt). Speziell ist ein raise_error() zur
   Verhinderung eines destructs nutzlos.
   Bitte macht in dieser Funkion nur das, was _unbedingt_ notwendig ist.
   Wenn jemand ein destruct() anwendet statt ein remove() zu rufen, hat das
   in der Regel einen Grund (z.B. um buggende remove() zu umgehen). Insb.
   ist ein save_object() in remove() und NotifyDestruct() vollstaendig
   ueberfluessig.


SIEHE AUCH
==========

   NotifyLeave(), NotifyInsert(), NotifyRemove()

Last modified: 25.02.2009, Zesstra