exec (STRING* program, STRING* options)
Öffnet ein externes Programm, Dokument, eine URL- oder Batch-Datei.
exec_wait (STRING* program, STRING* options)
Öffnet ein externes Programm, Dokument, eine URL oder Batch-Datei und wartet bis es / sie beendet ist.
Parameter:
program - Dateiname der exe, der Batch-Datei, URL oder des Dokuments die / das geöffnet werden soll.
options - Kommandozeilenparameter-String, der dem Programm übergeben werden soll oder NULL für keine Kommandozeilenoptionen.
Rückgabewerte:
0 wenn das Programm nicht gefunden wurde oder nicht gestartet werden konnte, ansonsten ungleich Null.
Geschwindigkeit:
Langsam
Bemerkungen:
- Der Parameter program kann einen kompletten Pfad (von der Wurzel an), einen teilweisen Pfad (aus dem gegenwärtigen Work-Ordner) oder nur einen Dateinamen angeben. In letzterem Fall sucht die Exec-Funktion nach der Datei im Work-Ordner und dann in den Ordnern, die von der PATH-Umgebungsvariablen des Systems angegeben wurden.
- Hat der program-String keine Dateinamen-Extension, versucht die exec-Funktion zuerst die Extension .COM, dann .EXE, danach .BAT und schließlich die Erweiterung .CMD.
- 7.82 Enthält der program-String eine URL oder den Namen eines Dokuments, wird der Standard-Internetbrowser oder der Standardeditor für dieses Dokument geöffnet.
- 7.79 "%PROG_DIR%" am Anfang des program-Strings wird durch den Ordner der Programmdateien ersetzt und "%EXE_DIR%" wird durch den Ordner ersetzt, der die ausführbare Engine enthält.
- '\'-Zeichen in Strings, wie etwa für Dateipfade müssen in C-Notation wie in "%PROG_DIR%\\internet explorer\\iexplore.exe" als "\\" angegeben werden.
- Die Anweisung wartet nicht bis das Programm beendet ist, sondern kehrt sofort zurück.
- Falls das externe Programm ein Fenster öffnet, sollte die Engine zuvor in den Fenstermodus umgeschaltet werden. Der Vollbildmodus würde andere Fenster verdecken.
- 7.79 Das externe Programm läßt sich mit der Funktion sys_message steuern.
Beispiele:
exec("%EXE_DIR%\\acknex.exe","samples\\terrain.hmp"); // open terrain in another engine window
exec("notepad","test.txt"); // open notepad
exec("%PROG_DIR%\\internet explorer\\iexplore.exe","http://www.3dgamestudio.com"); // open an URL with Internet Explorer
exec("http://www.3dgamestudio.com",NULL); // open an URL with the standard browser
Siehe auch:
PATH, sys_message, sys_active
► Aktuelle Version Online