MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame^] | 1 | SYNOPSIS |
| 2 | object first_inventory(); |
| 3 | object first_inventory(string ob); |
| 4 | object first_inventory(object ob); |
| 5 | |
| 6 | BESCHREIBUNG |
| 7 | Liefert das erste Objekt im Inventory von <obj>, wobei <obj> entweder |
| 8 | ein Objekt oder der Name eines Objekts ist. Wenn <obj> nicht angegeben |
| 9 | wird, wird standardmaessig this_object() verwendet. |
| 10 | |
| 11 | BEISPIELE |
| 12 | Diese Efun verwendet man am haeufigsten im folgenden Kontext: |
| 13 | |
| 14 | for(obj=first_inventory(container);obj;obj=next_inventory(obj)) |
| 15 | { |
| 16 | <irgendwelcher Code> |
| 17 | } |
| 18 | |
| 19 | ACHTUNG: Wenn das Objekt <obj> innerhalb von <irgendwelcher Code> |
| 20 | bewegt wird, liefert next_inventory() ein Objekt aus dem neuen |
| 21 | Inventory von <obj>. Auch sollte next_inventory() nicht fuer |
| 22 | zerstoerte Objekte <obj> aufgerufen werden. Fuer den Fall, dass |
| 23 | <obj> bewegt und/oder zerstoert wird, ist folgende Loesung |
| 24 | vorzuziehen: |
| 25 | |
| 26 | for(obj=first_inventory(container);obj;) |
| 27 | { |
| 28 | next=next_inventory(obj); |
| 29 | <irgendwelcher Code mit Moves oder Removes> |
| 30 | obj=next; |
| 31 | } |
| 32 | |
| 33 | SIEHE AUCH |
| 34 | next_inventory(E), all_inventory(E), environment(E), deep_inventory(E) |