doc/lfun/give_notify

give_notify()
*************


FUNKTION
========

   void give_notify(object obj);


DEFINIERT IN
============

   /std/npc/put_and_get.c


ARGUMENTE
=========

   obj
     an den NPC uebergebenes Objekt


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

   keiner


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

   Diese Funktion wird automatisch immer dann aufgerufen, wenn ein
   Lebewesen (welches kein Spielercharakter ist) ein Objekt uebergeben
   bekommt. Dies muss jedoch ueber die Funktionalitaet von
   put_and_get.c geschehen sein, innerhalb von move() wird die Funktion
   nicht aufgerufen!


BEISPIEL
========

   Oftmals will man in Quests erreichen, dass einem NPC ein bestimmtes
   Item als Beweis der Erfuellung einer bestimmten Aufgabe ueberbracht
   wird. Folgendermasse kann dies realisiert werden:
   void create() {
     ::create();
     ...
     SetProp(P_REJECT,({REJECT_GIVE,
       Name(WER)+" sagt: Das brauche ich nicht!\n"}));
     ...
   }

   void quest_ok(object obj) { ...
     // Vernichtung des Questobjektes und Questtexte
     // Questbelohnung und Questanerkennung
   }

   void give_notify(object obj) {
     if(obj->id("\nquestitem")) // Questitem bekommen?
       quest_ok(obj);
     else
       ::give_notify(obj);  // P_REJECT soll sonst greifen
   }
   Der Aufruf von ::give_notify() stellt sicher, dass ein Objekt
   zurueckgegeben wird, sofern es nicht das gesuchte ist. Erreicht wird
   dies ueber P_REJECT (siehe Bemerkungen).


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

   Speziell in NPCs ist diese Funktion normalerweise dafuer
   verantwortlich, dass mittels der Property P_REJECT die Annahme von
   Objekten verweigert werden kann. Ueberschreibt man sie, so sollte
   man gegebenenfalls darauf achten, dass diese Standardfunktion
   ebenfalls aufgerufen wird.


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

   P_REJECT, show_notify(),
   /std/npc/put_and_get.c, /std/living/put_and_get.c

22. Oktober 2013, Arathorn.