3.459
Bearbeitungen
Änderungen
keine Bearbeitungszusammenfassung
===Storestore===
Das '''<store>'''-Tag speichert seinen (ausgewerteten) Inhalt persistent, z.B. zwischen verschiedenen Schritten eines Quests.
Das Attribut 'name' gibt dabei an, unter welchem Namen es gespeichert werden soll. Der Inhalt selbst wird an dieser Stelle nicht ausgegeben.
Der folgende Code speichert '''Inhalt der Variable''' unter dem Namen 'VariablenName' für die Dauer des laufenden Quests:
<code syntaxhighlight lang="xml n">
<store name="VariablenName" scope="quest">Inhalt der Variable</store>
</codesyntaxhighlight>
===Scopes/Geltungsbereiche===
Den Bereich und die Art wie eine Variable gespeichert wird kann man über das Attribut '''scope''' festlegen.
Zu beachten ist, dass in [[Quest|Questen]] standardmäßig der scope "quest" eingestellt ist. Wird für eine Variable ein anderer Scope, z.B. 'hero', festgelegt und wird diese Variable später an einer anderen Stelle im Code verändert, dann muss der zugehörige Scope wieder explizit angegeben werden.
<store name="VariablenName" scope="hero">Inhalt der Variable</store>
</code> ====global====Die Variable wird unabhängig von Questen und Helden gespeichert.Sie wird nur manuell von Hand gelöscht. <code xml n><store name="VariablenName" scope="global">Inhalt der Variable</store></codesyntaxhighlight>
===expire===
Folgendes definiert eine Variable die nach 4 Ingame-Tagen wieder gelöscht wird.
<code syntaxhighlight lang="xml n">
<store name="VariablenName" scope="hero" expire="4d">Inhalt der Variable</store>
</codesyntaxhighlight>
Expire kann in zwei Formaten angegeben werden "4d" für vier Ingametage, "12h" für zwölf Ingamestunden oder "4D" für vier Reallife-Tage, "12H" für zwölf echte Stunden.
Mittels '''inc-expire''' kann der Zeitraum verlängert werden, indem eine Variable gültig ist.
<code syntaxhighlight lang="xml n">
<store name="meineVariable" scope="hero" expire="4d">Inhalt der Variable</store>
<store name="meineVariable" scope="hero" inc-expire="2d">neuer Inhalt der Variable</store>
<!-- die Variable ist somit insgesamt 6 Ingame-Tage aktiv -->
</codesyntaxhighlight>
===Variablen überschreiben===
Eine Variable kann einfach überschrieben werden, indem ihr ein neuer Inhalt zugewiesen wird:
<code syntaxhighlight lang="xml n">
<store name="held-hat-gefruehstueckt">nein</store>
...
<store name="held-hat-gefruehstueckt">ja</store>
</codesyntaxhighlight>
Zu beachten ist, dass in [[Quest|Questen]] standardmäßig der scope "quest" eingestellt ist. Wird für eine Variable ein anderer Scope, z.B. 'hero', festgelegt und wird diese Variable später an einer anderen Stelle im Code verändert, dann muss der zugehörige Scope wieder explizit angegeben werden:
<code syntaxhighlight lang="xml n">
<store name="held-ist-ein-schwarzer-ritter" scope="hero">nein</store>
...
<store name="held-ist-ein-schwarzer-ritter" scope="hero">ja</store><!-- Scope 'hero' muss hier wieder angegeben werden, sonst wird Variable nicht überschrieben, sondern eine neue Variable mit dem Scope "quest" gesetzt! -->
</codesyntaxhighlight>
===Variablen löschen===
Variablen können mittels
<code syntaxhighlight lang="xml n">
<store name="meineVar">NULL</store>
<!-- oder -->
<store name="meineVar"/>
</codesyntaxhighlight>
gelöscht werden.
Die Variablen können zwar technisch frei benannt werden, aber bei scope="hero"-Variablen ist zwingend auf einen aussagekräftigen und eindeutigen Namen zu achten. Dazu wird zunächst der Questname (+ggf. Autor) und danach die Variablenkennung angegeben, z.B.
<code syntaxhighlight lang="xml n">
<store name="SchiffBlutrabe-Tagesablauf" scope="hero">Schlaf</store>
</codesyntaxhighlight>
Diese Konvention soll sicherstellen, dass einzelne hero-/global-Variablen sich nicht gegenseitig überschreiben.
Folgendes bewirkt zum Beispiel die Ausgabe der Variable "papagei_name".
<code syntaxhighlight lang="xml n">
<p><q>Hallo <fetch name="papagei_name"/>!</q></p>
</codesyntaxhighlight>
===Inhalte ändern===
Grundsätzlich kann eine Variable jederzeit überschrieben werden und beinhaltet damit den neuen Wert. Sollte gewünscht sein, einen Zahlenwert zu erhöhen oder zu erniedrigen, siehe [[set]].
[[Kategorie:AOQML-Tags]]
