doc/sphinx/lfun/command_me.rst

command_me()
============

FUNKTION
--------
::

    int command_me(string str)

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

    string str - auszufuehrendes Kommando

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

    /std/npc.c, /std/player/command.c

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

    Fuehrt 'str' wie ein Kommando aus, welches direkt vom Living
    abgegeben wurde.

    Der Rueckgabewert ist >=1 fuer Erfolg und 0 fuer Misserfolg. 
    Rueckgabewert ist im Erfolgsfall die Hoehe der EvalCost in Ticks. 

    command_me() leitet den Befehl an command()(E) weiter und erlaubt
    dadurch auch den Aufruf von sonst durch "static" vor externem Aufruf
    geschuetzten Kommando-Funktionen.
    
    Kommandos mit oeffentlichen Kommandofunktionen (also damit alle mit
    AddCmd definierten Kommandos) koennen auch durch command()(E)
    von aussen ausgeloest werden.


BEMERKUNGEN
-----------
::

    - beruecksichtigt Aliase, d.h. wenn man Aliase eines Spielers
      ignorieren will, muss man ein \\ (fuer ein \ im Eingabestring)
      vor den Befehl stellen
    - fuer objektinterne Kommandos funktioniert also auch command()(E)

BEISPIEL
--------
::

    (Code des Testraum ist in /doc/beispiele/testobjekte/command_me_testraum)
    // #1: Testraum, zwinge Spieler bei "schleiche heran" zum Furzen
    //     command_me() ist hier noetig, da das Furzen eine geschuetzte
    //     Kommandofunktion hat
    inherit "/std/room";

    void create() {
      ::create();
      AddCmd("schleiche&heran|herum", "action_schleichen");
    }

    

    void init() {
      ::init();
      add_action("action_kriechen", "kriech", 1);
    }

    static int action_schleichen(string str) {
      string tmp = this_player()->QueryProp(P_RACE);
      // ... 
      if(tmp[<1]=='e') tmp=tmp[0..<2];
      write(break_string("Du versuchst leise zu schleichen, dabei passiert "
        "dir aber ein allzu "+
        (tmp=="Mensch"?"menschliches":lower_case(tmp)+"isches")+
        " Missgeschick. Verflucht!", 78));
      this_player()->command_me("\\furze");
      return 1;
    }

    

    static int action_kriechen(string str) {
      write(break_string("Deine Knie tun zu sehr weh dafuer.", 78));
      tell_room(this_object(), break_string(this_player()->Name(WER)+
        " knackt mit den Knien.", 78));
      return 1;
    }

    

    // #2 (in obigem Raum): zwinge Spieler in Raum zu obigem Kommando
    //    Beide Kommandos gelingen, da Kommando mit AddCmd definiert.
    find_player("naddl")->command_me("schleiche herum")
    command("schleiche herum", find_player("naddl")); 

    // #3 (in obigem Raum): zwinge Spieler in Raum zu obigem Kommando
    find_player("naddl")->command_me("krieche")
    //    Folgendes Kommando schlaegt fehl, da Kommandofunktion static ist.
    command("krieche", find_player("naddl"));

    

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

     enable_commands(E), command(E)

06 Sep 2012 Gloinson