doc/lfun/AddInfo - mudlib-public - Gitiles

 AddInfo()
 *********


 FUNKTION
 ========

    public varargs void AddInfo(string|string* key, string|closure
    info,
       string indent, int|string silent, string|closure casebased);


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

    /std/npc/info.c


 ARGUMENTE
 =========

    string|string* frage
       Schluesselphrase(n), fuer die der NPC eine Antwort geben soll,
       wenn man ihn danach fragt

    string|closure meldung
       Information, die gegeben werden soll; wenn 'meldung' eine
       Closure ist, wird der gerufenen Funktion die vom Spieler
       gefragte Schluesselphrase uebergeben.

    string indent    (optional)
       Text, der sich bei mehrzeiligen Meldungen wiederholen soll.

    int|string silent    (optional)
       Ist silent gesetzt, so erfolgt Antwort nur an Fragenden.

    string|closure casebased   (optional)
       Closure mit Returnwert string oder int. Der Funktion wird die
       vom Spieler gefragte Schluesselphrase uebergeben.


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

    Wenn ein Spieler ein NPC mittels "frage <monstername> nach <frage>"
    nach einer Information mit dem Schluessel 'frage' fragt, so wird
    die entsprechende 'meldung' ausgegeben (oder die Closure in
    'meldung' gerufen und der zurueckgegebene Text ausgegeben). Der
    Meldung wird der Name des Monsters vorangestellt.

    Frage:
       Schluesselphrasen muessen kleingeschrieben sein, koennen aber
       Leerzeichen enthalten.

    Meldung:
       Wenn kein 'indent' angegeben ist, muss man die Meldung selbst
       umbrechen.

    Indent:
       Wird ein 'indent' angegeben so wird jeder Zeile hinter dem
       Monsternamen noch das 'indent' vorangesetzt. Ein typisches
       indent ist "sagt: ".

    Silent:
       Bei 'silent'==1 erfolgt keine Textausgabe der Antwortmeldung im
       Raum, ist 'silent' ein String, so wird jener an alle anderen
       Spieler ausser dem Fragesteller im Raum ausgegeben. Dem
       ausgegebenen Text wird der Name des NPCs als Indent
       vorangestellt.

    Casebased:
       Die als Closure angegebene Methode entscheidet, ob oder wie der
       NPC auf diese Frage antworten soll:

       # return 0:    normale Antwort mit "meldung"

       # return 1:    keine Antwort/Antwort mit DEFAULT_NOINFO

       # return string: Antwort mit string unter Beruecksichtigung
       eines indent

    Die Strings von 'silent' und 'meldung' werden geparsed. Dabei
    koennen die @[...]-Tags von replace_personal() verwendet werden,
    Objekt 1 ist this_player(). Ersetzte Strings am Satzanfang werden
    automatisch gross geschrieben. AddInfo() konvertiert die alten
    Schluesselworte @WER, @WESSEN, @WEM, @WEN zu denen von
    replace_personal(), jedoch nicht in den Rueckgabe- werten von
    Closures.

    Mittels der in <npc.h> definierten Frage DEFAULT_INFO kann eine
    Meldung gesetzt werden, die gegeben werden soll, wenn der Spieler
    etwas fragt, auf das keine Antwort vorgegeben ist (das loest
    SetProp(P_DEFAULT_INFO, <text>) ab).


 BEISPIELE
 =========

    Siehe auch: /doc/beispiele/AddInfo/

    // Beispiel 1: ### eine Standardantwort setzen ###
    AddInfo(DEFAULT_INFO, "starrt Dir boese in die Augen.\n");
    // identisch zu
    // obsolet: SetProp(P_DEFAULT_INFO, "starrt Dir boese in die Augen.\n");

    // Beispiel 2: einfache Beispiele, auch mit casebased
    AddInfo(({"knete","kohle"}),
        "sagt: ich habe so etwas nicht.\n");
    AddInfo("geld",
        "Ich habe zwar kein Geld, aber [...] blablabla [...]",
        "sagt: ");
    AddInfo("muenzen",
        "fluestert: Du willst Geld?\n",
        0,
        "fluestert @WEM1 etwas zu.\n");

    // "frage monster nach geld": alle im Raum hoeren
    //  Das Monster sagt: Ich habe zwar kein Geld, aber [...]
    //  Das Monster sagt: [...] blablabla [...]

    // "frage monster nach muenzen":
    // - der Fragensteller hoert:
    //   "Das Monster fluestert: Du willst Geld?"
    // - alle andere hoeren:
    //   "Das Monster fluestert <Fragenstellernamen> etwas zu."

    // Beispiel 3: dynamisch
    // ein Prototyp, damit wir die Methode bekannt machen
    protected string query_kekse(string key);

    AddInfo(({"keks","kekse"}),
        #'query_kekse,        // ein Verweis auf die Funktion
        "sagt: ");

    protected string query_kekse(string key) {
      if(present("keks", this_object()))
        return("Ich hab noch welche. Aetsch!");
      else if(present("keks", environment()))
        return("Da liegt einer!");
      return("Menno. Keine mehr da!");
    }
    // "frage monster nach keks":
    // - wenn es noch Kekse hat, hoeren alle:
    //   "Das Monster sagt: Ich hab noch welche. Aetsch!
    // - sonst:
    //   "Das Monster sagt: "Menno. Keine mehr da!

    // Beispiel 4: dynamischer
    // ein Prototyp, damit wir die Methode bekannt machen
    protected string query_kekse(string key);
    protected mixed case_fighting(string key);

    AddInfo(({"keks","kekse"}),
        #'query_kekse,"        // ein Verweis auf die Funktion
        "sagt: ",
        0,                     // nicht silent :)
        #'case_fighting);      // noch ein Funktionsverweis

    protected string query_kekse(string key) {
      if(present("keks"))
        return("Ich hab noch welche. Aetsch!");
      return("Menno. Keine mehr da!");
    }

    protected mixed case_fighting(string key) {
      if(InFight())
        return("Keine Zeit fuer Kekse. Muss kaempfen.");
      return 0;
    }

    // "frage monster nach keks":
    // - wenn es kaempft, hoeren alle:
    //   "Das Monster sagt: Keine Zeit fuer Kekse. Muss kaempfen.
    // - sonst, wenn es noch Kekse hat, hoeren alle:
    //   "Das Monster sagt: Ich hab noch welche. Aetsch!
    // - sonst:
    //   "Das Monster sagt: "Menno. Keine mehr da!

    // Beispiel 5: ### dynamisch und komplex ###
    // ein Prototyp, damit wir die Methode bekannt machen
    protected string question_gold(string key);

    // "gold" wird eine Closure auf die Methode question_gold()
    // zugewiesen, ausserdem soll es still bleiben (wir informieren
    // den Restraum selbst)
    AddInfo("gold", #'question_gold, "murmelt: ", 1);

    // los gehts, wir generieren unsere Antwort selbst
    protected string question_gold(string key) {
      // wieviel Kohle hat der Spieler
      int money = this_player()->QueryMoney();
      string* valuables = ({});

      // Wertgegenstaende suchen, d.h. Material kein Gold,
      // Objekt kein Geld, und auch nicht unsichtbar
      foreach(object o : deep_inventory(this_player()))
      {
        if ( o->QueryMaterial(MAT_GOLD)>0 &&
             load_name(o) != "/items/money" &&
             o->QueryProp(P_SHORT) &&
             !o->QueryProp(P_INVIS) )
        {
          valuables += ({o->Name(WER,1)});
        }
      }

      // das geht an alle anderen im Raum, silent bietet sich hier
      // nicht an, weil es mehrere Moeglichkeiten gibt
      send_room(environment(),
        sprintf("%s murmelt %s etwas zu%s.",
                Name(WER,1),
                this_player()->name(WEM,1),
                (money || sizeof(valuables))?
                  " und glotzt "+this_player()->QueryPronoun(WEN)+
                  " gierig an" : ""),
        MT_LOOK|MT_LISTEN,
        MA_EMOTE, 0, ({this_player()}));

      // Und hier die Antwort an den Spieler selbst, mit diversen
      // Verzweigungen fuer dessen Besitztum.
      string reply = "Ich hab kein Gold bei mir.";
      string verb = sizeof(valuables) ? "ist" : "sind";
      if ( money )
      {
        reply += " Aber Du hast ja jede Menge Kohle bei dir, so etwa "+
                 money+" Muenzen.";
        if ( sizeof(valuables) )
          reply += sprintf(" Ausserdem %s auch noch %s aus Gold.",
                     verb, CountUp(valuables));
      }
      else if ( sizeof(valuables) )
      {
          reply += sprintf(
            " Aber Du hast ja ein paar Wertsachen dabei: %s %s aus Gold.",
            CountUp(valuables), verb);
      }
      return reply;
    }

    // "frage monster nach gold"
    // - der Fragesteller hoert zB:
    //   Das Monster murmelt: Ich hab kein Gold bei mir. Aber Du hast ja
    //   Das Monster murmelt: jede Menge Kohle bei Dir, so etwa <number>
    //   Das Monster murmelt: Muenzen. Ausserdem ist/sind noch <object1>
    //   Das Monster murmelt: und <object2> aus Gold."
    // - die Umstehenden hoeren:
    //   "Das Monster murmelt @WEM1 etwas zu."
    //   oder
    //   "Das Monster murmelt @WEM1 etwas zu und glotzt ihn/sie gierig an."


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

    Verwandt:
       AddSpecialInfo(), RemoveInfo()

    Props:
       P_PRE_INFO

    Files:
       /std/npc/info.c

    Loggen:
       P_LOG_INFO

    Interna:
       GetInfoArr() , do_frage()

 09.08.2021, Zesstra
	AddInfo()
	*********


	FUNKTION
	========

	public varargs void AddInfo(string\|string* key, string\|closure
	info,
	string indent, int\|string silent, string\|closure casebased);


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

	/std/npc/info.c


	ARGUMENTE
	=========

	string\|string* frage
	Schluesselphrase(n), fuer die der NPC eine Antwort geben soll,
	wenn man ihn danach fragt

	string\|closure meldung
	Information, die gegeben werden soll; wenn 'meldung' eine
	Closure ist, wird der gerufenen Funktion die vom Spieler
	gefragte Schluesselphrase uebergeben.

	string indent (optional)
	Text, der sich bei mehrzeiligen Meldungen wiederholen soll.

	int\|string silent (optional)
	Ist silent gesetzt, so erfolgt Antwort nur an Fragenden.

	string\|closure casebased (optional)
	Closure mit Returnwert string oder int. Der Funktion wird die
	vom Spieler gefragte Schluesselphrase uebergeben.


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

	Wenn ein Spieler ein NPC mittels "frage <monstername> nach <frage>"
	nach einer Information mit dem Schluessel 'frage' fragt, so wird
	die entsprechende 'meldung' ausgegeben (oder die Closure in
	'meldung' gerufen und der zurueckgegebene Text ausgegeben). Der
	Meldung wird der Name des Monsters vorangestellt.

	Frage:
	Schluesselphrasen muessen kleingeschrieben sein, koennen aber
	Leerzeichen enthalten.

	Meldung:
	Wenn kein 'indent' angegeben ist, muss man die Meldung selbst
	umbrechen.

	Indent:
	Wird ein 'indent' angegeben so wird jeder Zeile hinter dem
	Monsternamen noch das 'indent' vorangesetzt. Ein typisches
	indent ist "sagt: ".

	Silent:
	Bei 'silent'==1 erfolgt keine Textausgabe der Antwortmeldung im
	Raum, ist 'silent' ein String, so wird jener an alle anderen
	Spieler ausser dem Fragesteller im Raum ausgegeben. Dem
	ausgegebenen Text wird der Name des NPCs als Indent
	vorangestellt.

	Casebased:
	Die als Closure angegebene Methode entscheidet, ob oder wie der
	NPC auf diese Frage antworten soll:

	# return 0: normale Antwort mit "meldung"

	# return 1: keine Antwort/Antwort mit DEFAULT_NOINFO

	# return string: Antwort mit string unter Beruecksichtigung
	eines indent

	Die Strings von 'silent' und 'meldung' werden geparsed. Dabei
	koennen die @[...]-Tags von replace_personal() verwendet werden,
	Objekt 1 ist this_player(). Ersetzte Strings am Satzanfang werden
	automatisch gross geschrieben. AddInfo() konvertiert die alten
	Schluesselworte @WER, @WESSEN, @WEM, @WEN zu denen von
	replace_personal(), jedoch nicht in den Rueckgabe- werten von
	Closures.

	Mittels der in <npc.h> definierten Frage DEFAULT_INFO kann eine
	Meldung gesetzt werden, die gegeben werden soll, wenn der Spieler
	etwas fragt, auf das keine Antwort vorgegeben ist (das loest
	SetProp(P_DEFAULT_INFO, <text>) ab).


	BEISPIELE
	=========

	Siehe auch: /doc/beispiele/AddInfo/

	// Beispiel 1: ### eine Standardantwort setzen ###
	AddInfo(DEFAULT_INFO, "starrt Dir boese in die Augen.\n");
	// identisch zu
	// obsolet: SetProp(P_DEFAULT_INFO, "starrt Dir boese in die Augen.\n");

	// Beispiel 2: einfache Beispiele, auch mit casebased
	AddInfo(({"knete","kohle"}),
	"sagt: ich habe so etwas nicht.\n");
	AddInfo("geld",
	"Ich habe zwar kein Geld, aber [...] blablabla [...]",
	"sagt: ");
	AddInfo("muenzen",
	"fluestert: Du willst Geld?\n",
	0,
	"fluestert @WEM1 etwas zu.\n");

	// "frage monster nach geld": alle im Raum hoeren
	// Das Monster sagt: Ich habe zwar kein Geld, aber [...]
	// Das Monster sagt: [...] blablabla [...]

	// "frage monster nach muenzen":
	// - der Fragensteller hoert:
	// "Das Monster fluestert: Du willst Geld?"
	// - alle andere hoeren:
	// "Das Monster fluestert <Fragenstellernamen> etwas zu."

	// Beispiel 3: dynamisch
	// ein Prototyp, damit wir die Methode bekannt machen
	protected string query_kekse(string key);

	AddInfo(({"keks","kekse"}),
	#'query_kekse, // ein Verweis auf die Funktion
	"sagt: ");

	protected string query_kekse(string key) {
	if(present("keks", this_object()))
	return("Ich hab noch welche. Aetsch!");
	else if(present("keks", environment()))
	return("Da liegt einer!");
	return("Menno. Keine mehr da!");
	}
	// "frage monster nach keks":
	// - wenn es noch Kekse hat, hoeren alle:
	// "Das Monster sagt: Ich hab noch welche. Aetsch!
	// - sonst:
	// "Das Monster sagt: "Menno. Keine mehr da!

	// Beispiel 4: dynamischer
	// ein Prototyp, damit wir die Methode bekannt machen
	protected string query_kekse(string key);
	protected mixed case_fighting(string key);

	AddInfo(({"keks","kekse"}),
	#'query_kekse," // ein Verweis auf die Funktion
	"sagt: ",
	0, // nicht silent :)
	#'case_fighting); // noch ein Funktionsverweis

	protected string query_kekse(string key) {
	if(present("keks"))
	return("Ich hab noch welche. Aetsch!");
	return("Menno. Keine mehr da!");
	}

	protected mixed case_fighting(string key) {
	if(InFight())
	return("Keine Zeit fuer Kekse. Muss kaempfen.");
	return 0;
	}

	// "frage monster nach keks":
	// - wenn es kaempft, hoeren alle:
	// "Das Monster sagt: Keine Zeit fuer Kekse. Muss kaempfen.
	// - sonst, wenn es noch Kekse hat, hoeren alle:
	// "Das Monster sagt: Ich hab noch welche. Aetsch!
	// - sonst:
	// "Das Monster sagt: "Menno. Keine mehr da!

	// Beispiel 5: ### dynamisch und komplex ###
	// ein Prototyp, damit wir die Methode bekannt machen
	protected string question_gold(string key);

	// "gold" wird eine Closure auf die Methode question_gold()
	// zugewiesen, ausserdem soll es still bleiben (wir informieren
	// den Restraum selbst)
	AddInfo("gold", #'question_gold, "murmelt: ", 1);

	// los gehts, wir generieren unsere Antwort selbst
	protected string question_gold(string key) {
	// wieviel Kohle hat der Spieler
	int money = this_player()->QueryMoney();
	string* valuables = ({});

	// Wertgegenstaende suchen, d.h. Material kein Gold,
	// Objekt kein Geld, und auch nicht unsichtbar
	foreach(object o : deep_inventory(this_player()))
	{
	if ( o->QueryMaterial(MAT_GOLD)>0 &&
	load_name(o) != "/items/money" &&
	o->QueryProp(P_SHORT) &&
	!o->QueryProp(P_INVIS) )
	{
	valuables += ({o->Name(WER,1)});
	}
	}

	// das geht an alle anderen im Raum, silent bietet sich hier
	// nicht an, weil es mehrere Moeglichkeiten gibt
	send_room(environment(),
	sprintf("%s murmelt %s etwas zu%s.",
	Name(WER,1),
	this_player()->name(WEM,1),
	(money \|\| sizeof(valuables))?
	" und glotzt "+this_player()->QueryPronoun(WEN)+
	" gierig an" : ""),
	MT_LOOK\|MT_LISTEN,
	MA_EMOTE, 0, ({this_player()}));

	// Und hier die Antwort an den Spieler selbst, mit diversen
	// Verzweigungen fuer dessen Besitztum.
	string reply = "Ich hab kein Gold bei mir.";
	string verb = sizeof(valuables) ? "ist" : "sind";
	if ( money )
	{
	reply += " Aber Du hast ja jede Menge Kohle bei dir, so etwa "+
	money+" Muenzen.";
	if ( sizeof(valuables) )
	reply += sprintf(" Ausserdem %s auch noch %s aus Gold.",
	verb, CountUp(valuables));
	}
	else if ( sizeof(valuables) )
	{
	reply += sprintf(
	" Aber Du hast ja ein paar Wertsachen dabei: %s %s aus Gold.",
	CountUp(valuables), verb);
	}
	return reply;
	}

	// "frage monster nach gold"
	// - der Fragesteller hoert zB:
	// Das Monster murmelt: Ich hab kein Gold bei mir. Aber Du hast ja
	// Das Monster murmelt: jede Menge Kohle bei Dir, so etwa <number>
	// Das Monster murmelt: Muenzen. Ausserdem ist/sind noch <object1>
	// Das Monster murmelt: und <object2> aus Gold."
	// - die Umstehenden hoeren:
	// "Das Monster murmelt @WEM1 etwas zu."
	// oder
	// "Das Monster murmelt @WEM1 etwas zu und glotzt ihn/sie gierig an."


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

	Verwandt:
	AddSpecialInfo(), RemoveInfo()

	Props:
	P_PRE_INFO

	Files:
	/std/npc/info.c

	Loggen:
	P_LOG_INFO

	Interna:
	GetInfoArr() , do_frage()

	09.08.2021, Zesstra