doc/sphinx/lfun/RemoveExtraLook.rst

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
---------

.. code-block:: pike

    // (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");

.. code-block:: pike

    // (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);

.. code-block:: pike

    // (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:
     :doc:`AddExtraLook`, :doc:`../props/P_INTERNAL_EXTRA_LOOK`, :doc:`../lfun/HasExtraLook`
   Sonstiges:
     :doc:`../sefun/replace_personal`, :doc:`../sefun/break_string`
   Fuer Spielerobjekte:
     :doc:`../props/P_EXTRA_LOOK`

15. Jun 2017 Gloinson