Quelle und Ziel

Skripte > Klassen-Elemente und C++-Befehle > Parserklasse-Methoden > Plugin-Methoden > Quelle und Ziel

Prototyp

str SourceName()

void SourceName(const str& xsSourceName, bool xbLastFile = true)

str TargetName()

void TargetName(const str& xsTargetName)

str SourceRoot()

void SourceRoot(const str& xsSourceRoot)

str TargetRoot()

void TargetRoot(const str& xsTargetRoot)

Beschreibung

Diese Funktionen liefern die aktuellen Quell- und Ziel-Verzeichnisse und -Dateien. Sinnvoll ist die Benutzung dieser Funktionen vor allem für den Transformations-Manager, das  Kommandozeilen-Werkzeug und im generierten Code. In der TETRA  Arbeitsoberfläche  werden diese Pfade aus dem aktuellen Projekt-Verzeichnis und dem Namen "Unbenannt.txt" zusammengesetzt, wenn nicht zuvor Texte im Quell-Fenster geladen bzw. im Ziel-Fenster gespeichert wurden.

str SourceName()

gibt den Namen der aktuellen Quelldatei inclusive absolutem Pfad zurück.

str TargetName()

gibt den Namen der aktuellen Zieldatei inclusive absolutem Pfad zurück.

str SourceRoot()

gibt den absolutem Pfad des obersten Quellverzeichnisses zurück.

str TargetRoot()

gibt den absolutem Pfad des obersten Zielverzeichnisses zurück.

bool IsLastFile()

gibt an, ob es sich um die letzte einer Reihe von Dateien handelt. Diese Information, kann wichtig sein, wenn eine Reihe von Quelldateien zu nur einer Zieldatei verarbeitet werden, um bestimmte Aktionen mit der letzten Datei abzuschließen. Werden jeweils einzelne Quelldateien in einzelne Zieldateien transformiert, gibt die Funktion true zurück.

void SourceName(const str& xsSourceName, xbLast = true)

void TargetName(const str& xsTargetName)

void SourceRoot(const str& xsSourceRoot)

void TargetRoot(const str& xsTargetRoot)

Der Name der aktuellen Quelldatei kann im erzeugten Code nicht automatisch ermittelt werden, kann aber mit dieser Funktion von Programmierer gesetzt werden. Das Gleiche gilt für das Quell- und das Zielverzeichnis.

Beim Setzen des Namens der Quelldatei, kann mit dem zweiten Parameter xbLast gesetzt werden, ob es sich bei der Datei um die letzte einer Reihe handelt. Per default ist xbLast == true, da in 1:1-Transformationen jede Quelldatei zugleich die letzte der jeweiligen Transformation ist.

str str()

Befindet man sich nicht in der TextTransformer IDE und wurde die Ausgabe nicht in eine Datei umgelenkt, so wird sie in einen Puffer des Plugins geschrieben. 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.

Diese Seite gehört zur TextTransformer Dokumentation