doc/efun/object_info

GESCHUETZT
SYNOPSIS
        #include <objectinfo.h>

        mixed * object_info(object ob, int what)
        mixed * object_info(object ob, int what, int index)

BESCHREIBUNG
        Liefert einige interne Informationen ueber das Objekt <ob> in Form
        eines Arrays. Das Argument <what> gibt an, welche Informationen
        geliefert werden.

        Das Resultat ist normalerweise ein Array. Wird jedoch <index>
        spezifiziert, wird nur der Wert geliefert, der im Array an der
        Position <index> stehen wuerde.

        Die moeglichen Werte fuer <what> und die Indizes des gelieferten
        Arrays sind in <objectinfo.h> definiert und muessen eingebunden
        werden. Diese Definitionen koennen sich in zukuenftigen Versionen
        des Drivers aendern!

        <what> == OINFO_BASIC:

        Dieser Aufruf liefert grundlegende Informationen ueber <ob>:
        int [OIB_HEART_BEAT]:       1, wenn <ob> einen heart_beat() hat,
                                    sonst 0.
        int [OIB_IS_WIZARD]:        1, wenn <ob> ein Gott ist (das
                                    Wizard Flag gesetzt hat), sonst 0. Der
                                    Eintrag ist immer 0, wenn set_is_wizard()
                                    nicht verfuegbar ist.
        int [OIB_ENABLE_COMMANDS]:  1, wenn <ob> Kommandos geben darf, sonst 0.
        int [OIB_CLONE]:            1, wenn <ob> ein Clon ist, sonst 0.
        int [OIB_DESTRUCTED]:       1, wenn <ob> zerstoert wurde, sonst 0.
        int [OIB_SWAPPED]:          1, wenn <ob> geswapt wurde, sonst 0.
        int [OIB_ONCE_INTERACTIVE]: 1, wenn <ob> einmal interaktiv war,
                                    sonst 0.
        int [OIB_RESET_STATE]:      1, wenn <ob> im gleichen Zustand wie nach
                                    einem reset() ist, sonst 0.
        int [OIB_WILL_CLEAN_UP]:    1, wenn <ob> clean_up() aufruft, sonst 0.
        int [OIB_LAMBDA_REFERENCED]:1, wenn <ob> Lambdas beinhaltet, sonst 0.
        int [OIB_SHADOW]:           1, wenn <ob> ein Schatten uebergeworfen
                                    wurde, sonst 0.
        int [OIB_REPLACED]:         1, wenn das Programm von <ob> ersetzt
                                    wurde (mit replace_program()), sonst 0.
        int [OIB_NEXT_RESET]:       Zeit bis zum naechsten Reset.
        int [OIB_TIME_OF_REF]:      Zeit des letzen Aufrufs von <ob>.
        int [OIB_REF]:              Anzahl Aufrufe von <ob>.
        int [OIB_GIGATICKS]:        GIGATICKS und TICKS liefern die summierten
        int [OIB_TICKS]:            Evalkosten von <ob>.
        int [OIB_SWAP_NUM]:         Die Swap-Nummer von <ob>s Programm, oder
                                    -1, wenn <ob> nicht geswapt wurde.
        int [OIB_PROG_SWAPPED]:     1, wenn <ob>'s Programm geswapt wurde,
                                    sonst 0.
        int [OIB_VAR_SWAPPED]:      1, wenn <ob>'s Variablen geswapt wurden,
                                    sonst 0.
        int [OIB_NAME]:             der Objektname von <ob>.
        object [OIB_NEXT_ALL]:      das naechste Objekt in der Objektliste.
        object [OIB_PREV_ALL]:      das vorherige Objekt in der Objektliste.

        <what> == OINFO_POSITION:

        Dieser Aufruf liefert Informationen ueber die Position von <ob> in der
        globalen Objektliste:

        object [OIP_NEXT]:          naechstes Objekt in der Objektliste.
        object [OIP_PREV]:          vorheriges Objekt in der Objektliste.
        int [OIP_POS]:              die Position von <ob> in der Objektliste,
                                    beginnend von 0 aufwaerts.

        Dieser Aufruf kann aufwendig an Rechenzeit sein.

        <what> == OINFO_MEMORY:

        Dieser Aufruf liefert Informationen ueber Speichernutzung von <ob>.

        int [OIM_REF]:                Anzahl Referenzierungen von <ob>.
        string [OIM_NAME]:            Name von <ob>.
        int [OIM_PROG_SIZE]:          Programmgroesse.
        int [OIM_NUM_FUNCTIONS]:      Anzahl Funktionen in <ob>.
        int [OIM_SIZE_FUNCTIONS]:     Speicherbedarf der Funktionen
        int [OIM_NUM_VARIABLES]:      Anzahl Variablen im Programm.
        int [OIM_SIZE_VARIABLES]:     Speicherbedarf der Variablen.
        int [OIM_NUM_STRINGS]:        Anzahl Strings im Programm.
        int [OIM_SIZE_STRINGS]:       Speicherbedarf der String-Pointer.
        int [OIM_SIZE_STRINGS_DATA]:  Speicherbedarf der String-Daten,
                                      korrigiert um das Ausmass des Daten-
                                      Sharing.
        int [OIM_SIZE_STRINGS_TOTAL]: unkorrigierter Speicherbedarf der
                                      String-Daten.
        int [OIM_NUM_INCLUDES]:       Anzahl Includefiles im Programm.
        int [OIM_NUM_INHERITED]:      Anzahl inheriter Programme.
        int [OIM_SIZE_INHERITED]:     Speicherbedarf der Inherits.
        int [OIM_TOTAL_SIZE]:         Gesamter Speicherbedarf des Programms.
        int [OIM_DATA_SIZE]:          Gesamte Speicherbedarf der Variablenwerte
                                      des Objekts <ob>, korrigiert um das
                                      Ausmass des Daten-Sharings.
        int [OIM_DATA_SIZE_TOTAL]:    unkorrigierter Gesamter Speicherbedarf
                                      der Variablenwerte des Objekts.
        int [OIM_NO_INHERIT]:         1, wenn das Programm nicht inheritet
                                      werden kann.
        int [OIM_NO_CLONE]:           1, wenn das Programm / der Blueprint
                                      nicht geclont werden kann.
        int [OIM_NO_SHADOW]:          1, wenn dem Objekt kein Shadow
                                      uebergeworfen werden darf.

        Dieser Aufruf holt das Programm aus dem Swap, falls notwendig.
        Die OIM_SIZE_xxx-Eintraege zeigen nur den Speicherbedarf der
        Strukturen / Pointer an, nicht aber den Speicherbedarf von
        Variablenwerten, Funktionscode oder der Strings selbst.


GESCHICHTE
        Eingefuehrt in LDMud 3.2.6.
        Aenderungen in LDMud 3.2.7:
          - neues Kriterium OIB_REPLACED.
          - das Kriterium OIB_IS_WIZARD ist immer 0, wenn set_is_wizard()
            nicht verfuegbar ist.
          - das Kriterium OIB_APPROVED wurde entfernt.
        LDMud 3.2.8 fuehrte neu OIM_DATA_SIZE im Resultat von OINFO_MEMORY ein.
        LDMud 3.2.9 erweiterte OINFO_MEMORY um den Index Mechanismus,
            OIM_NUM_INCLUDES, OIM_NO_INHERIT, OIM_NO_SHADOW, OIM_NO_CLONE,
            OIM_SIZE_STRINGS_DATA, OIM_SIZE_STRINGS_TOTAL, und
            OIM_DATA_SIZE_TOTAL

SIEHE AUCH
        debug_info(E)