Kwave-Skripte

Allgemeine Struktur

Ein Kwave-Skript besteht aus einer Liste von Zeilen, wobei jede Zeile in eine der folgenden Kategorien eingeteilt werden kann:

  • ein einzelner Befehl,

  • eine Befehls-Liste, mit zwei oder mehr per ; voneinander getrennten Befehlen.

  • ein Kommentar,

  • eine Markierung

  • oder eine Leerzeile, die nur aus Leerzeichen besteht

Kommentare und Leerzeilen

Alle Zeichen die einem # folgen (außer wenn in Anführungszeichen gesetzt oder mit vorgestelltem Escape-Zeichen) werden als Kommentare behandelt, sie werden stillschweigend ignoriert.

Zeilen die nur aus Leerzeichen oder Kommentaren bestehen werden ebenfalls ignoriert.

Beenden

Ein Kwave-Skript beendet sich entweder wenn alle Befehle ohne einen Fehler ausgeführt wurden oder sobald ein Befehl einen Fehlercode zurück gibt. Es gibt keinen speziellen Befehl zum Abbrechen eines Skriptes. Falls Sie jedoch eine Möglichkeit vorsehen wollen dass der Anwender ein Skript beenden kann, so steht Ihnen der Befehl msgbox(Text) zur Verfügung. Dieser zeigt ein Benachrichtigungs-Fenster mit den beiden Schaltflächen OK (um das Skript weiter auszuführen) und der Schaltfläche Abbrechen (um das Skript zu beenden).

Markierungen

Zeilen die nur aus einem Bezeichner gefolgt von einem : bestehen werden als Markierungen betrachtet. Auf diese kann man sich an anderen Stellen im Skript mit dem Schlüsselwort GOTO [2] beziehen, das bewirkt dass die Ausführung des Skriptes an der Stelle mit der angegebenen Markierung fortgesetzt wird (siehe Beispiel unten).

Eine Zeile mit einer Markierung darf nach dem : keinen anderen Inhalt (mit Ausnahme von Kommentaren und Leerzeichen) enthalten.

Beispiel:

start:  # <= dies ist eine Markierung
                    # tue irgendwas...
                    msgbox(noch einmal?)
                    GOTO start
        



[2] Hinweis: Bitte verwechseln Sie nicht das Schlüsselwort GOTO mit dem Textbefehl goto (Position) !