U_REQ
*****


NAME
====

   U_REQ                         "u_req"


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

   /sys/unit.h


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

   Die Prop kann in Unitobjekten gesetzt werden.
   Sie gibt die Anzahl der Einheiten an, die an der Unit manipuliert werden
   sollen, falls mit weniger als P_AMOUNT umgegegangen werden soll.


   Die Prop wird automatisch gesetzt, wenn id() an einem Unitobjekt gerufen
   wird und die ID grundsaetzlich zutreffend ist, die aus der ID ermittelte
   Zahl aber kleiner als P_AMOUNT ist.
   Sie kann auch manuell mittel SetProp() (aber nicht Set()) gesetzt werden.

   U_REQ wird beim Bewegen und Zerstoeren, bei Ermittlung von Wert und
   Gewicht beruecksichtigt.

   U_REQ wird vom Unitobjekt automatisch wieder auf P_AMOUNT gesetzt, wenn
   sich query_verb() oder debug_info(DINFO_EVAL_NUMBER) veraendert haben.
   (DINFO_EVAL_NUMBER ist eine Zahl, die sich jedesmal erhoeht, wenn der
    Driver eine neue Berechnung/Ausfuehrung beginnt. Diese Nummer wird fuer
    jeden vom driver initiierten Aufruf von LPC-Code erhoeht, z.B. bei jedem
    Kommando, call_out, heart_beat etc. Details s. debug_info().)

   Ebenso wird U_REQ bei der Vereinigung mit einem anderen (gleichen)
   Objekt auf P_AMOUNT des vereinigten Objektes gesetzt.


BUGS
====

   Viele. Dies ist ein uebler Hack. Geht aber nicht ohne.
   Diese Prop war endlos lang gar nicht dokumentiert. Hier beschrieben ist
   das Verhalten, was zur Zeit vorliegt. Dies mag unterschiedlich zu dem
   irgendwann intendierten sein.


BEISPIELE
=========

   object o = clone_object("unitobjekt");
   o->SetProp(P_AMOUNT, 100);   // ab jetzt hat o 100 Einheiten.
   o->move(npc, M_GET);         // ob mit 100 Einheiten wird bewegt
   o->SetProp(U_REQ, 50);
   o->move(anderernpc, M_GIVE); // 50 Einheiten werden bewegt, 50 verbleiben
   (Technisch: das Objekt wird auf 50 Einheiten geaendert, bewegt und in der
    alten Umgebung wird ein neues Objekt mit 50 Einheiten erzeugt.)

   o->SetProp(U_REQ, 42);
   o->remove(1);               // 42 Einheiten von den 50 werden zerstoert.
   (Technisch: P_AMOUNT wird einfach um U_REQ reduziert.)

   # gib 18 muenzen an blupp
   Hierbei wird ob->id("18 muenzen") gerufen, was U_REQ im Geldobjekt auf 18
   setzt. Bei der Bewegung bekommt blupp daher das Objekt mit P_AMOUNT==18
   und der Rest wird im Abgebenden neu erzeugt.
   # gib geld an flubbel
   Das U_REQ aus dem verherigen Kommando ist jetzt nicht mehr gueltig. Zwar
   ist es das gleiche Kommandoverb, aber DINFO_EVAL_NUMBER ist jetzt
   anders.


ZULETZT GEAeNDERT
=================

16.01.2015, Zesstra