id()¶

FUNKTION¶

varargs int id(string str, int lvl);

DEFINIERT IN¶

/std/thing/description.c
/std/player/base.c

ARGUMENTE¶

string str
     String, auf den getestet werden soll.
int lvl
     In /std/player/base.c benutzt. Wenn der Spieler unsichtbar ist
     und lvl kleiner ist als sein Level, wird 0 zurueckgegeben.

BESCHREIBUNG¶

Es wird geprueft, ob sich das Objekt mit str ansprechen laesst. Dazu
wird str mit dem Inhalt der Property P_IDS verglichen. Falls
P_ADJECTIVES gesetzt ist, werden auch alle Adjektivkombinationen mit
den Bezeichnern geprueft.

Besondere Bedeutung hat diese Funktion bei Mengenobjekten: Anhand von
str wird vermerkt, welche Menge des Objektes angesprochen wird. Es
werden dabei mehrere Faelle unterschieden:
o str ist einer der mit AddId() angegebener Bezeichner. In diesem
  Fall ist die angesprochene Menge die Gesamtmenge.
o str ist einer der mit AddSingularId() angegebenen Bezeichner. Die
  angesprochene Menge ist in diesem Fall 1.
o str ist einer der mit AddPluralId() angegebenen Bezeichner. Die
  angesprochene Menge ist in diesem Fall . die Gesamtmenge.
o Hat str die Form "<n> <id>", wobei <n>=1 und <id> eine SingularId
  oder 1 < <n> <= der Gesamtmenge und <id> eine PluralId, so ist die
  angesprochene Menge = <n>.
Wie gesagt, gilt dies einzig und allein bei Mengenobjekten!

RUeCKGABEWERT¶

1, wenn sich das Objekt von str angesprochen fuehlt, ansonsten 0.

BEISPIELE¶

Angenommen, ein Objekt habe folgende Bezeichner:

AddId( "murmel" );
AddAdjective( "runde" );

Dann liefern die angegebenen id()-Aufrufe folgende Ergebnisse:

id( "murmel" );         => 1
id( "runde murmel" );   => 1
id( "kleine murmel" );  => 0
id( "runder ball" );    => 0
id( "runde murmel 2" ); => 1, wenn dies die zweite Murmel in der
                              gleichen Umgebung ist, ansonsten 0

Bei einem Haufen von 100 Muenzen haette man zB.:

AddId( "geld" );
AddSingularId( "muenze" );
AddPluralId( "muenzen" );

Nach fuehlen sich nach den folgenden id()-Aufrufen folgende Anzahlen
angesprochen:

id( "geld" );       => 100 Muenzen
id( "muenze" );     => 1 Muenze
id( "muenzen" );    => 100 Muenzen
id( "1 muenze" );   => 1 Muenze
id( "42 muenzen" ); => 42 Muenzen

id() liefert in all diesen Faellen 1 zurueck.

SIEHE AUCH¶

AddId(), AddAdjective(), AddSingularId(), AddPluralId(), present(),
match_ids(), /std/thing/description.c, /std/unit.c

Sep 2012 Gloinson