execFührt ein externes Programm ausBeschreibungstringfalseexecstringcommandarrayoutput&null;intresult_code&null;exec führt einen angegebenen Befehl
(command) aus.
&reftitle.parameters;
command
Der auszuführende Befehl
output
Ist der Parameter output vorhanden, wird
das angegebene Array mit jeder Zeile der Befehlsausgabe gefüllt. Am Ende
einer jeweiligen Zeile stehende Whitespaces wie beispielsweise
ein \n werden nicht in dieses Array übernommen.
Beachten Sie, dass wenn das Array bereits Elemente enthält, die Funktion
exec die Ausgabe an das Array anhängt. Wenn
Sie dieses nicht wünschen, rufen Sie die Funktion unset
für das Array auf, bevor Sie es als Parameter der
Funktion exec übergeben.
result_code
Ist der Parameter result_code zusammen mit
dem Parameter output angegeben, so
wird der Rückgabestatus des ausgeführten Befehls in diese
Variable geschrieben.
&reftitle.returnvalues;
Die letzte Zeile der Ausgabe des Befehls. Wenn ein Befehl ausgeführt werden
muss und alle Daten des Befehls direkt ohne Umweg über ein Array ausgegeben
werden sollen, kann die Funktion passthru verwendet
werden.
Gibt bei einem Fehler &false; zurück.
Um die Ausgabe des ausgeführten Befehls zu erhalten, muss sichergestellt
werden, dass der Parameter output gesetzt und
verwendet wird.
&reftitle.errors;
Wenn exec den Befehl command
nicht ausführen kann, wird eine Meldung der Stufe
E_WARNING ausgegeben.
Löst einen ValueError aus, wenn
command leer ist oder Nullbytes enthält.
&reftitle.changelog;
&Version;&Description;8.0.0
Wenn command leer ist oder Nullbytes enthält,
löst exec nun einen
ValueError aus. Zuvor gab die Funktion ein
E_WARNING aus und gab &false; zurück.
&reftitle.examples;
Ein exec-Beispiel
]]>
&example.outputs.similar;
cmb
)
]]>
&reftitle.notes;
&warn.escapeshell;
¬e.exec-bg;
¬e.exec-bypass-shell;
&reftitle.seealso;
systempassthruescapeshellcmdpcntl_execbacktick operator