Function

Mit Hilfe des <function>-Tags können in AOQML interne Abfragen gemacht werden.

Syntax

<function name="" [param1="" param2="" param3="" ... ] />

• name beschreibt hierbei den Namen der Funktion
• param1 ist der erste Parameter, der der Funktion übergeben wird
• param2 (optional) ist der zweite Parameter, der der Funktion übergeben wird.

Beachte: Jede Funktion benötigt eine vorgeschriebene Anzahl an Parametern, dazu bitte bei der Anwendung der Funktion nachlesen.

Das Ergebnis einer Funktion wird ausgegeben. Um das Ergebnis weiter zu nutzen, kann man den <function>-Tag durch ein store umschließen.

Funktionen

Funktion "ist-urgott-in-pantheon"

Diese Funktion erlaubt die Prüfung, ob ein Urgott durch eine Gottheit in einem Pantheon repräsentiert wird.

Erwartet werden zwei Parameter: 'param1' steht für den Urgott, 'param2' für das Pantheon.

Rückgabe der Funktion ist 'true' oder 'false'.

Beispiel:

<!-- prüfe, ob Urgott 'Epohe' bei den Halblingen repräsentiert wird. Erwartet: true -->
<function name="ist-urgott-in-pantheon" param1="Epohe" param2="Halblinge" />

Noch ein Beispiel:

<store name="test"><function name="ist-urgott-in-pantheon" param1="Nerga" param2="Amazonen" /></store>
<p>Test: prüfe, ob 'Nerga' bei den Amazonen vorkommt. Erwartet: false, Ergebnis: <fetch name="test" /></p>

Funktion "ist-segelschiff"

Die Funktion prüft, ob das aktuelle Fortbewegungsmittel (auf Reisen) ein Segelschiff ist. Es wird kein Parameter erwartet. Rückgabe der Funktion ist 'true' oder 'false'.

Beispiel:

<!-- prüfen, ob Segelschiff. Falls nicht, die ZB/Quest nicht starten -->
<store name="segel"><function name="ist-segelschiff"/></store>
<switch name="segel">
  <case val="false">
    <quest status="rejected"/>
  </case>
</switch>

Funktion "waren-wiederfinden"

Die Funktion ist für besonders seltene Zufallsbegegnungen vorgesehen. Sie erlaubt, ehemals verlorene Gegenstände des Helden in derselben ZB wiederzufinden. Als Parameter (param1) kann angegeben werden, ob auch verlorene Gegenstände von anderen Helden gefunden werden können (standardmäßig aktiv), oder ob nur eigene Gegenstände wiedergefunden werden können (wenn 'false').
Rückgabe der Funktion ist 'true' (wenn mindestens 1 Gegenstand wiedergefunden wurde) oder 'false' (wenn kein Gegenstand aufgenommen wurde).

Beispiel:

<!-- Gegenstände in ZB wiederfinden -->
<function name="waren-wiederfinden" />

<!-- wenn nur EIGENE Gegenstände wiedergefunden werden sollen (keine von fremden Helden) -->
<store name="rueck"><function name="waren-wiederfinden" param1="false"/></store>
<has name="rueck" val="true" show="none">
  <success>
    <p>Da liegen ja längst verloren geglaubte Sachen von dir - na die packst du aber schnell ein!</p>
  </success>
  <failure>
    <p>Schade, du findest nichts interessantes.</p>
  </failure>
</has>