| |
| 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 |