doc/lfun/create

create()

FUNKTION:
     protected void create();
     void create();

DEFINIERT IN:
     allen Standardobjekten

ARGUMENTE:
     keine

BESCHREIBUNG:
     Diese Funktion wird aufgerufen, wenn ein Objekt geladen oder geclont
     wird.
     In dieser Funktion wird das Objekt initialisiert und konfiguriert.
     Waehrend des create() kann es einen this_player()/this_interactive()
     geben, muss aber nicht!
     Im create() hat das Objekt noch kein environment().
     create() wird nur gerufen, wenn das Objekte geclont oder explizit geladen
     wird. Wenn es aufgrund eines inherit in einem anderen Objekt vom Driver
     geladen wird, wird das create() nicht ausgefuehrt (s. create_super()).

RUeCKGABEWERT:
     keiner

BEMERKUNGEN:
     Erbt man von anderen Objekten, so besteht die erste Aktion innerhalb
     von create() normalerweise darin, in diesen Objekten create()
     aufzurufen.
     Die Funktion kann protected oder static sein (aber nicht private). Es
     duerfte fuer die meisten Objekte sinnvoll sein, create() protected zu
     deklarieren.

     Um Speicher zu sparen, kann man bei Blueprints von der Konfigurierung
     absehen (siehe Beispiel). Dies sollte man allerdings nicht bei Objekten
     machen, von denen keine Clones erzeugt werden sollen (zB. bei Raeumen). 

     Man sollte bei Abbruch des create() in BP unbedingt set_next_reset(-1);
     rufen, da sonst die (nicht konfigurierte) BP resetten kann und dann
     buggt.

BEISPIELE:
     Ein Gegenstand wuerde wie folgt konfiguriert:

     inherit "std/thing";

     #include <properties.h>

     create()
     {
       // Wenn wir die Blueprint sind: NICHT konfigurieren!
       // Bei normalen Raeumen oder Transportern sind diese beiden
       // Zeilen wegzulassen!!!
       if (!clonep(this_object())) {
           set_next_reset(-1);    // wichtig, damit die BP nicht resettet.
           return;
       }

       // Ansonsten die allgemeinen Eigenschaften von /std/thing
       // konfigurieren...
       ::create();

       // ...und nun unsere speziellen Eigenschaften:
       SetProp(P_NAME, "Muell");
       SetProp(P_SHORT, "Muell");
       SetProp(P_LONG, "Voellig unnuetzer Muell!\n");
       SetProp(P_ARTICLE, 0);
       SetProp(P_VALUE, 0);
       SetProp(P_GENDER, MALE);
     }

SIEHE AUCH:
     create(L), reset(L)
     hook(C), create(H), create_ob(H), create_super(H, reset(H)
     create(A), reset(A)
----------------------------------------------------------------------------
22.10.2007, Zesstra