Preprozessor-Anweisungen sind Spezialbefehle, die vor der eigentlichen Abarbeitung des Skripts ausgeführt werden. Diese Spezialbefehle gehören immer an den Anfang eines Skripts und müssen allein in einer Zeile stehen.
#!hs2 kennzeichnet die Verwendung der neuen Skriptsprache. Die alte Skriptsprache wird nicht mehr unterstützt. Diese Zeile muss ohne führende Leerzeichen und ohne folgende Parameter in der allerersten Zeile stehen, um wirksam zu sein.
Achtung: Obwohl die Skripte derzeit auch ohne diese Anweisung funktionieren, sollten Sie sie an den Beginn der Skripte setzen, um mögliche Konflikte bei eventuellen Änderungen in der Zukunft zu vermeiden.
#!trace 1 schaltet die Anzeige aller
ausgeführten Programmzeilen im Hamster-Protokoll ein, um Tests
und das Debuggen („Entwanzen“, Suchen und Entfernen
von Programmierfehlern) von Skripten zu erleichtern. Siehe hierzu auch
die Prozedur „trace“.
Dieser Befehl eignet sich insbesondere zum Anzeigen des
Initialisierungs-Abschnittes von Modulen.
#!debug <level> setzt den Debug-Level, Standard ist 0. Mit dem Debug-Level 0 werden alle „debug“-Befehle ignoriert. Der Debug-Level 255 zeigt alle „debug“-Befehle an.
#!load <module>.hsm lädt das betreffende Modul und erlaubt die Benutzung der dort definierten Funktionen, siehe dazu unter Module.
#!initialize kennzeichnet den Beginn eines Initialisierungsabschnittes, der stets zuerst ausgeführt wird. Kann in jedem Skript verwendet werden, ist aber besonders sinnvoll in Modulen, mehr siehe deshalb dort. Darf ohne „#!finalize“ verwendet werden. Außerhalb von Modulen muss der Initialisierungsabschnitt nach dem Hauptskript stehen und nach der „return“-Anweisung zusätzlich mit „quit“ abgeschlossen werden.
#!finalize kennzeichnet den Beginn eines Finalisierungsabschnittes, der stets als letztes ausgeführt wird. Kann ebenso in jedem Skript verwendet werden, ist aber besonders sinnvoll in Modulen, mehr siehe deshalb dort. Darf nicht ohne „#!initialize“ verwendet werden und muss nach diesem auftreten, sonst gibt es in beiden Fällen eine Fehlermeldung. Außerhalb von Modulen ist der Finalisierungsabschnitt zusätzlich mit „quit“ abzuschließen.
#!menu:<hauptmenüpunkt>=<Menübezeichnung> Sofern das Skript im Skriptpfad bzw. einem Unterpfad gespeichert ist, wird es mit der gewählten Menübezeichnung unter dem ausgewählten Hauptmenüpunkt in das bestehende Hamster-Menü eingefügt und kann auf diese Art bequem gestartet werden. Als Hauptmenüpunkt stehen zur Verfügung: „File“ (Menü „Datei“), „Config“ (Menü „Einstellungen“), „Online“ (Menü „Online“), „Local“ (Menü „Lokale Server“), „Tools“ (Menü „Tools“) und „Help“ (Menü „Hilfe“). Sofern sich kein Skript für den Menüpunkt „Tools“ per obiger Anweisung registriert, wird dieser Hauptmenüpunkt gar nicht angezeigt.