Skript neu starten (os.restart)

Deklaration

Operationsergebnis, Fehlermeldung = os.restart([ Skriptdateipfad ])

Parameter

• Skriptdateipfad
  Textwert, optional; bei einem gültigen Skriptdateipfad wird das Zielskript neu gestartet, Standardwert "".

Rückgabewert

• Operationsergebnis
  Boolescher Wert; bei einem Fehler false. Ein Fehler ist nur möglich, wenn der Parameter Skriptdateipfad übergeben wurde; bei Erfolg kehrt die Funktion nicht zurück, da der Prozess neu gestartet wurde.
• Fehlermeldung
  Textwert; konkrete Fehlermeldung bei einem Fehler.

Beschreibung

Ohne Skriptdateipfad startet die Funktion direkt den Prozess des aktuellen Skripts neu; das aktuelle Skript wird sofort beendet.
Bei einem gültigen Skriptdateipfad wird das aktuelle Skript beendet und das Zielskript neu gestartet.
Bei einem Fehler gibt die Funktion false mit einer Fehlermeldung zurück; meistens wird der Fehler durch ungültige Parameter verursacht.

Hinweise

Aktuelles Skript bezeichnet die beim Start geladene Skriptdatei. Wenn die Skriptdatei geändert wurde, lädt os.restart() nicht die geänderte Datei.
Verwende diese Funktion nach Möglichkeit nicht in einer Umgebung mit mehreren Threads.
Ein Neustart ohne Verzögerung kann andere logische Probleme verursachen, die vom Skriptautor selbst vermieden werden müssen.

Beispiel 1

os.restart() -- zum „aktuellen Skript“ neu starten (nicht zur „aktuellen Skriptdatei")

Beispiel 2

os.restart(utils.launch_args().path) -- zur „aktuellen Skriptdatei“ neu starten

Hinweis: Der obige Code verwendet die Funktion utils.launch_args aus einem anderen Kapitel.