
MayAddWeight()
**************


FUNKTION
========

   int MayAddWeight(int gewicht);


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

   /std/container/restrictions.c


ARGUMENTE
=========

   gewicht
        Das zu pruefende Gewicht.


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

   Wenn ein Objekt ein einen Behaelter bewegt wird, prueft move() ueber
   diese Funktion, ob das Objekt ueberhaupt noch in den Behaelter hinein
   passt. Dazu uebergibt move() dieser Funktion das Gewicht des zu
   bewegenden Objektes.


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

   0, wenn der Behaelter noch ein gewicht Gramm wiegendes Objekt aufnehmen
   kann, -1 im anderen Fall.


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

   move() ruft diese Funktion nicht auf, wenn in den Flags M_NOCHECK
   gesetzt war!


BEISPIELE
=========

   Die entsprechende Abfrage in /std/thing/moving.c sieht etwa
   folgendermassen aus:

   int weight;

   ...
   weight = QueryProp(P_TOTAL_WEIGHT);   // Behaelter? Ja => Gesamtgewicht
   if (!weight)
     weight = QueryProp(P_WEIGHT);       // Nein: einfaches Gewicht

   if (ziel->MayAddWeight(weight) == -1) // Passt es noch rein?
     return ME_TOO_HEAVY;                // Nein, entspr. Fehler zurueckgeben

   ...


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

   MayAddObject(), PreventInsert(), move(), /std/container/restrictions.c

Last modified: 23.09.2007, Zesstra