blob: 99be7fdca1558e050e73e329c4544d2a78039fa9 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
2 object first_inventory();
3 object first_inventory(string ob);
4 object first_inventory(object ob);
5
6BESCHREIBUNG
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
11BEISPIELE
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
33SIEHE AUCH
34 next_inventory(E), all_inventory(E), environment(E), deep_inventory(E)