Bezeichnung
RunRexxScript -- führt ein ARexx-Skript aus einer Datei oder dem Arbeitsspeicher aus (V2.5)
Übersicht
res$ = RunRexxScript(script$[, nofile])
Plattformen
Nur AmigaOS und kompatible

Beschreibung
Mit diesem Befehl können Sie das im skript$ angegebene ARexx-Skript ausführen. Darüber hinaus können Sie auch ein ARexx-Code direkt ausführen, indem Sie das optionale Argument nofile auf True setzen. In diesem Fall darf das skript$ kein Pfad zu einem ARexx-Skript beinhalten, muss aber den auszuführenden ARexx-Code enthalten. Der Befehl gibt das Ergebnis aus dem ARexx-Skript zurück. Der Rückgabewert ist immer eine Zeichenfolge, auch wenn er nur eine Zahl enthält. Wenn ARexx nichts zurückgibt, erhalten Sie eine leere Zeichenfolge.

Vor der Verwendung dieses Befehls müssen Sie RexxMast starten. Es ist jedoch nicht notwendig, einen ARexx-Port zu erstellen, um diesen Befehl nutzen zu können. Dieser Befehl funktioniert auch, wenn Ihr Skript keinen ARexx-Port hat. Das Skript wird immer mit "REXX" als Host-Port gestartet. Wenn Sie also einen anderen Port adressieren möchten, müssen Sie zuerst den Befehl "ADDRESS" von ARexx verwenden.

Wenn Sie diesen Befehl zum Starten externer ARexx-Skripts verwenden, stellen Sie sicher, dass die erste Zeile Ihres ARexx-Skripts ein Kommentar ist. Ansonsten erhalten Sie eine Fehlermeldung "Programm nicht gefunden". Als Syntax muss die erste Zeile aller ARexx-Skripts ein Kommentar sein.

Siehe auch CreateRexxPort() und SendRexxCommand().

Eingaben
script$
Pfad zu einem externen direkten ARexx-Skript oder ARexx-Code; im letzteren Fall muss nofile True sein
nofile
optional: False, um das in script$ angegebene Arexx-Skript zu starten (enthält einen Pfad zu einem ARexx-Skript) und True, wenn script$ ein ARexx-Code ist (standardmäßig ist False).
Rückgabewerte
res$
Rückgabewert von ARexx; dies ist immer eine Zeichenfolge
Beispiel
RunRexxScript("dh0:MyScript.rx")
Der obige Code führt das Skript "dh0:MyScript.rx" aus.


r$ = RunRexxScript("SAY 'Hello'\nRETURN 5\n", True)
Der obige Code gibt "Hello" über die Konsole aus und gibt 5 an Hollywood zurück. Die Variable r$ enthält also nach dem Aufruf "5".

Navigation zeigen