replace_personal()
******************


FUNKTION
========

   varargs string replace_personal(string str, mixed *obs [, int caps]);


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

   /secure/simul_efun.c


ARGUMENTE
=========

   str    - zu bearbeitender String
   obs    - Liste von Objekt1, Objekt2, ..., Objekt9
            (Objekte oder Strings)
   caps   - 1 fuer Grossschreibung des Ersetzten nach Satzenden (.,?,!,")
            0 sonst


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

   Ersetzt in Strings
   @WERx, @WESSENx, @WEMx, @WENx durch
      Objectx->name(<casus>, 1);
   @WERUx, @WESSENUx, @WEMUx, @WENUx durch
      Objectx->name(<casus>);
   @WERQPx, @WESSENQPx, @WEMQPx, @WENQPx durch
      Objectx->QueryPronoun(<casus>);
   @WERQAx, @WESSENQAx, @WEMQAx, @WENQAx durch
      Objectx->QueryArticle(<casus>, 1, 1);
   @WERQPPGNx, @WESSENQPPGNx, @WEMQPPGNx, @WENQPPGNx durch
      Objectx->QueryPossPronoun(<gender>, <casus>, <number>);
   oder den entsprechenden String bei "Objektx".


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

   x steht fuer die Position des Objekts/Strings in *obs, beginnend bei 1.

   Besonderheiten beim Possessivpronomen (@WERQPPGNx):
   G muss durch das Geschlecht (M, F oder N) und N durch den Numerus (S
   oder P) ersetzt werden.
   Alle Angaben, auch der CASUS, beziehen sich dabei auf das Objekt, welches
   besessen wird, nicht auf den Besitzer! Dieser ist bereits durch x
   bestimmt.


RUeCKGABEWERT
=============

   durchersetzter String


Beispiele
=========

   replace_personal("@WER1", ({find_player("gloinson")})) ==> "Gloinson"

   replace_personal("@WEMQP1", ({find_player("gloinson")})) ==> "ihm"

   // unbestimmter und bestimmter Artikel:
   replace_personal("@WER1 zueckt @WENU2 und verhaut @WEN3.",
                    ({find_player("gloinson"),
                      find_object("/obj/mpa"),
                      find_object("/obj/wanderer")}))
   ==> "Gloinson zueckt eine Zeitung und verhaut den Wanderer."

   // Beim Possessivpronomen beziehen sich WEN, F und P (Akkusativ,
   // Femininum, Plural) auf die Taschen, nicht auf Kessa:
   replace_personal("@WER1 steckt @WESSEN2 Turnschuhe in @WENQPPFP1 "
                    "Taschen.",
                    ({find_player("kessa"),
                      find_player("gloinson")}))
   ==> "Kessa steckt Gloinsons Turnschuhe in ihre Taschen."

   // Ein Beispiel mit laengerem *obs:
   replace_personal("@WER1 zieht @WENQPPMP1 neuen Turnschuhe an. @WER2 ist "
                    "so beeindruckt, dass @WERQP2 @WEMQP1 @WENU3 auf die "
                    "@WEN4 haut und die Schuhe in @WEMQPPFS2 Tasche "
                    "verschwinden laesst. @WERU5 schaut zu und kichert "
                    "irre. Wenn das @WER6 gesehen haette!",
                    ({find_player("gloinson"),
                      find_player("kessa"),
                      find_object("/obj/mpa"),
                      "Birne",
                      find_object("/obj/wanderer"),
                      find_netdead("jof")}),1)
   ==> "Gloinson zieht seine neuen Turnschuhe an. Kessa ist so "
       "beeindruckt, dass sie ihm eine Zeitung auf die Birne haut und die "
       "Schuhe in ihrer Tasche verschwinden laesst. Ein Wanderer schaut "
       "zu und kichert irre. Wenn das Jof gesehen haette!"


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

   AddCmd(L)

5. September 2015, Arathorn