Schreibt Daten in den STDERR-Stream. Einige Texteditoren können diesen Stream lesen. Es gibt auch Programme, die diesen Stream lesen können, oder sogar Daten hierüber erwarten.
ConsoleWriteError ( "data" )
data | Die Daten, welche ausgegeben werden sollen. Kann Text oder Binärcode sein. |
Die Aufgabe dieser Funktion ist es, in den STDERR-Stream zu schreiben. Viele der bekannten Texteditoren können diesen Stream lesen.
Skripte, die als Kommandozeilenapplikation übersetzt werden, benutzen ebenfalls den STDERR-Strem.
Wenn das Skript nicht als Kommandozeilenapplikation übersetzt wurde, kann es nicht in eine DOS-Konsole (CMD) schreiben.
Die Zeichen werden nach ANSI konvertiert bevor sie geschrieben werden.
Die Binärdaten werden geschrieben wie sie sind. Sie werden nicht in einen String gewandelt. Um den HEX-Wert der Binärdaten zu schreiben muss die String() Funktion benutzt werden um explizit die Daten in einen String zu schreiben.
@error und @extended werden beim Return nicht gesetzt und bleiben so, wie sie vor dem Aufruf waren. Dies ist beim Debuggen mit der SciTE-Debugging-Ausgabe nützlich.
Local $sString = "Es ist ein Fehler aufgetreten."
ConsoleWriteError($sString & @CRLF) ; Wird dies in einem Texteditor gestartet, welcher die Ausgabe in die Konsole verarbeiten kann, so wie z. B. SciTE, so wird der Wert von $sString dargestellt.