GetDetail()
===========

FUNKTION
--------
::

    varargs string GetDetail(string key, string race, int sense)

DEFINIERT IN
------------
::

    /std/thing/description.c

ARGUMENTE
---------
::

    key
      Das zu ermittelnde Detail.
    race
      Rasse des ermittelnden Objektes (falls es ein Lebewesen ist).
    sense
      Die Art des zu untersuchenden Details:
        Untersuchen, Riechen, Hoeren, Tasten.

BESCHREIBUNG
------------
::

    Die Beschreibung des gewuenschten Details wird ermittelt. Dabei
    werden rassenspezifische Details beruecksichtigt. Es gibt hierbei
    verschiedene Detailarten, deren Typ man in <sense> angibt:
      SENSE_VIEW    - Fuer Defaultdetails zum Untersuchen.
      SENSE_SMELL   - Fuer Details, die man riechen kann.
      SENSE_SOUND   - Fuer Details, die man hoeren kann.
      SENSE_TOUCH   - Fuer Details, die man abtasten kann.
      SENSE_READ    - Fuer Details, die man lesen kann.

    Dabei ist 0 == SENSE_VIEW.

RUeCKGABEWERT
-------------
::

    Die Beschreibung des Details oder 0, wenn es dieses Detail nicht
    gibt.

HINWEIS
-------
::

    Fuer SENSE_VIEW und SENSE_READ wird die Funktion gar nicht erst 
    aufgerufen, wenn der Spieler nichts sehen kann. Das gleiche gilt fuer
    SENSE_SOUND, wenn der Spieler taub ist.

BEISPIEL
--------
::

    Im folgenden wird ein kleines Testdetail generiert:
      AddDetail("test","Das ist ein Test!\n");

    Im folgenden wird das Detail entfernt, wenn es existiert. Dies ist
    eigentlich nicht noetig, da RemoveDetail() damit zurechtkommt, aber
    eventuell sind ja noch weitere Aktionen noetig.
      if(GetDetail("test")) { 
        RemoveDetail("test");
        ...
      }

    Einen Geruch kann man folgendermassen erzeugen:
      AddSmells("gold",
        ([0      :"Gold kann man nicht riechen!\n",
          "zwerg":"Deine trainierte Nase riecht es muehelos!\n"]));
    Die Abfrage des Details gestaltet sich recht einfach:
      GetDetail("gold","zwerg",SENSE_SMELL);
    Die Funktion liefert das Detail fuer den Zwerg.
      GetDetail("gold",0,SENSE_SMELL);
    Die Funktion liefert das Detail fuer die restlichen Rassen.
      GetDetail("gold",0,SENSE_SOUND);
    Ein Sounddetail mit dem Namen "gold" existiert nicht, die Funktion
    liefert 0 zurueck.

SIEHE AUCH
----------
::

    Setzen:    AddDetail(), AddReadDetail(), AddSmells(), AddSounds(),
               AddTouchDetail()
    Loeschen:  RemoveReadDetail(), RemoveSmells(), RemoveDetail(),
               RemoveSounds(), RemoveTouchDetail()
    Daten:     P_DETAILS, P_READ_DETAILS, P_SMELLS, P_SOUNDS,
               P_TOUCH_DETAILS, P_SPECIAL_DETAILS
    Veraltet:  AddSpecialDetail(), RemoveSpecialDetail(), P_READ_MSG
    Sonstiges: break_string()

27. Jan 2013 Gloinson