doc/lfun/AddSpecialExit

AddSpecialExit()
****************


FUNKTION
========

   void AddSpecialExit(string|string* cmd, string|closure func);


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

   /std/room/exits


ARGUMENTE
=========

   string/string* cmd
        die Richtung(en), in die der Ausgang fuehrt
   string/closure func
        der Name der aufzurufenden Funktion/Closure


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

   Es wird ein Ausgang in die Richtung(en) cmd eingefuegt. Wird der
   Ausgang benutzt, so wird die Closure bzw. Funktion func ausgefuehrt.

   AddSpecialExit(cmd, "func") entspricht:
   - AddExit(keys, #'func)


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

   In func muss man den Spieler selbst in den Zielraum bewegen. Im
   Erfolgsfall sollte man einen Wert >0 zurueckgeben, im Fehlerfall einen
   Wert <=0.

   func bekommt als Parameter einen String mit der gewaehlten
   Bewegungsrichtung uebergeben.


BEISPIELE
=========

   // ein Ausgang soll nur von Froeschen benutzbar sein:

   AddSpecialExit("loch", "lochfkt");
   // der gleiche Aufruf, nur anders:
   // static int lochfkt(string dir);         // Prototyp
   // ...
   // AddSpecialExit("loch", #'lochfkt);
   // auch identisch zu:
   // AddExit("loch", #'lochfkt);

   static int lochfkt(string dir) {
     if (!(this_player()->QueryProp(P_FROG))) {
       // Kein Frosch => passt nicht!
       notify_fail("Du bist zu gross!\n");
       return 0;
     }
     // Meldungen werden im move() gleich mitgegeben
     return this_player()->move("/room/loch", M_GO, 0,
                  "huepft ins Loch", "huepft herein");
   }


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

   AddExit(), GetExits(),
   RemoveExit(), RemoveSpecialExit(),
   GuardExit(),
   H_HOOK_EXIT_USE, P_EXITS, P_HIDE_EXITS, /std/room/exits.c
   ausgaenge

Letzte Aenderung: 22.12.2016, Bugfix