Umlenkung der Ausgabe

Skripte > Klassen-Elemente und C++-Befehle > Parserklasse-Methoden > Plugin-Methoden > Umlenkung der Ausgabe

Syntax

void RedirectOutput( const str& xsFilename )

void RedirectOutputBinary( const str& xsFilename )

void RedirectOutput( const str& xsFilename, bool xbAppend )

void RedirectOutputBinary( const str& xsFilename, bool xbAppend )

void ResetOutput( )

obsolet:

void RedirectCout( const str& xsFileName, bool xbAppend);

void ResetCout()        

Beschreibung

Nach Aufruf der RedirectOutput-Anweisung werden alle Ausgaben in die Datei geschrieben, deren Namen mit dem Parameter xsFileName angegeben wurde. D.h. out steht dann für die Datei xsFileName. Falls eine Datei diesen Namens nicht existiert, wird sie automatisch angelegt.

Standardmäßig wird eine vorhandene Datei gleichen Namens überschrieben. Wenn als zweiter Parameter xbAppend der boolsche wert true übergeben wird, wird die neue Ausgabe an den vorhandenen Text angehängt.

RedirectOutputBinary funktioniet analog wie RedirectOutput, jedoch wird die Datei im im Binär-Format geschrieben, d.h. das Zeilenende-Zeichen '\n' wird nicht automatisch in die Kombintion "\r\n" umgewandelt.

Der Befehl wird nur innerhalb der Transformations-Managers, des Kommandozeilenprogramms oder dem exportierten Code wirksam. In der Arbeitsoberfläche wird die Ausgabe stets vollständig in das Ausgabefenster geschrieben.

RedirectOutput kann nicht benutzt werden, wenn für die Zieldatei die UTF8-Kodierung gesetzt ist. Durch diese Option wird RedirectOutput bereits einmal ausgeführt.

Mit RedirectOutput kann das Ziel der Transformation auch in mehrere Dateien aufgesplittet werden.

Mit ResetOutput wird der ursprüngliche Zustand wiederhergestellt, bei dem die Ausgabe in in die ursprüngliche Datei geschrieben wird.

Den Inhalt des Plugin-Puffers erhält man mit der str-Methode des Plugins:

xState.GetPlugin().str().

Beim Aufruf dieser Methode wird der Puffer zugleich geleert.

Es ist weder nötig ResetOutput vor einem Wechsel der Zieldatei mit RedirectOutput noch am Ende einer Transformation aufzurufen.

Diese Seite gehört zur TextTransformer Dokumentation