Function

Aus AntamarWiki
Wechseln zu: Navigation, Suche

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.

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>