
RemoveExtraLook()
*****************


FUNKTION
========

   int RemoveExtraLook(string key);


DEFINIERT IN
============

   /std/living/description.c


ARGUMENTE
=========

   * string key: Schluessel, unter dem der Extralook registriert
     wurde ODER Objektname des registrierenden Objektes


BESCHREIBUNG
============

   Der Extralook erscheint in der Langbeschreibung des Lebewesens.

   Eintraege koennen mit dieser Funktion (vorzeitig) wieder entfernt
   werden. Dazu wird entweder der selbst festgelegte Schluessel oder
   der implizite Schluessel *object_name()* des setzenden Objekts
   benoetigt.


BEMERKUNGEN
===========

   Beim Entfernen mit dieser Funktion wird die "Endemeldung" des
   entfernten Eintrages nicht ausgegeben.


RUECKGABEWERTE
==============

   Siehe auch /sys/living/description.h fuer Konstanten.

   * 1, falls der Eintrag erfolgreich entfernt wurde.

   * < 0 sonst.

     * -1: keinen (gueltigen) <key> uebergeben.

     * -2: kein Eintrag fuer <key> gefunden.


BEISPIELE
=========

   // (1) Loeschen ueber expliziten Key
   living->AddExtraLook(
     "@WER1 wird von einer Horde Daemonen verfolgt.",
     1800, "ennox_daemonenhordenverfolgerlook");

   // Nun kann der Eintrag auch wieder entfernt werden:
   living->RemoveExtraLook("ennox_daemonenhordenverfolgerlook");

   // (2) Loeschen ueber impliziten Objektnamen-Schluessel
   living->AddExtraLook("Eine Sonnenblume ragt aus dem Ohr.")
   // das ist nur aus dem gleichen Objekt heraus moeglich:
   living->RemoveExtraLook(0);

   // (3) Loeschen ueber impliziten Objektnamen-Schluessel
   string implizite_id = object_name(this_object());
   living->AddExtraLook("Eine Sonnenblume ragt aus dem Ohr.")
   // diese ID kann man natuerlich durch die Gegend schicken
   living->RemoveExtraLook(implizite_id);


SIEHE AUCH
==========

   Verwandt:
      AddExtraLook(), P_INTERNAL_EXTRA_LOOK, HasExtraLook()

   Sonstiges:
      replace_personal(), break_string()

   Fuer Spielerobjekte:
      P_EXTRA_LOOK

15. Jun 2017 Gloinson