Flower

← Alle Module · Daten & Formate

textdatei

Liest und bearbeitet beliebige Text-Dateien zeilen- und inhaltsweise — von einfachem Lesen über Suchen und Ersetzen bis zum Einfügen, Setzen oder Entfernen einzelner Zeilen. Ideal für Logdateien, Konfigurationen, CSV-Rohdaten oder jede unstrukturierte Textdatei.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiText—Pfad zur Text-Datei, auf der der ganze Block arbeitet. Für lesende und ändernde Aktionen erforderlich; existiert die Datei nicht, gilt sie als leer und wird beim ersten Schreiben angelegt.
encodingText—Zeichenkodierung der Datei. Standard 'auto' erkennt UTF-8/UTF-16 anhand der BOM (sonst UTF-8). Alternativ ein fester IANA-Name wie 'utf-8' oder 'windows-1252'.

Aktionen

lesenlesend

Liest den vollständigen Inhalt der Datei als Text.

Ausgaben (über ergebnis:)

ergebnisDer gesamte Datei-Inhalt als ein zusammenhängender Text (Zeilen mit Zeilenumbruch verbunden).

zeile-lesenlesend

Liest eine einzelne Zeile anhand ihrer 1-basierten Zeilennummer.

Eingaben

FeldTypPflichtBeschreibung
nummerZahlja1-basierte Zeilennummer; muss innerhalb der vorhandenen Zeilen liegen.

Ausgaben (über ergebnis:)

ergebnisDer Text der angeforderten Zeile.

zeilen-lesenlesend

Liest einen Bereich von Zeilen (von..bis) als Liste.

Eingaben

FeldTypPflichtBeschreibung
vonZahljaErste zu lesende Zeile (1-basiert, muss >= 1 sein).
bisZahljaLetzte zu lesende Zeile; darf nicht vor 'von' liegen. Liegt 'bis' hinter dem Dateiende, werden nur die verfügbaren Zeilen geliefert.

Ausgaben (über ergebnis:)

ergebnisListe der Zeilen-Texte im angegebenen Bereich.

zeilen-zählenlesend

Zählt die Anzahl der Zeilen in der Datei.

Ausgaben (über ergebnis:)

anzahlAnzahl der Zeilen als Zahl (eine abschließende Leerzeile durch ein End-Newline zählt mit).

suchenlesend

Sucht ein Muster zeilenweise und liefert alle Treffer mit Zeile und Nummer.

Eingaben

FeldTypPflichtBeschreibung
musterTextjaSuchtext oder — bei aktivem regex — regulärer Ausdruck.
regexWahrheit—Wenn wahr, wird 'muster' als regulärer Ausdruck ausgewertet. Standard: falsch.
groß-klein-egalWahrheit—Wenn wahr, wird Groß-/Kleinschreibung ignoriert. Standard: falsch.

Ausgaben (über ergebnis:)

trefferListe der Treffer; jeder Eintrag ist ein Objekt mit 'zeile' (Text) und 'nummer' (1-basierte Zeilennummer).

enthältlesend

Prüft, ob die Datei ein Muster irgendwo enthält.

Eingaben

FeldTypPflichtBeschreibung
musterTextjaSuchtext oder — bei aktivem regex — regulärer Ausdruck.
regexWahrheit—Wenn wahr, wird 'muster' als regulärer Ausdruck ausgewertet. Standard: falsch.

Ausgaben (über ergebnis:)

ergebnisWahr, wenn das Muster im gesamten Datei-Inhalt vorkommt, sonst falsch.

schreibenverändernd

Überschreibt die Datei vollständig mit dem angegebenen Text.

Eingaben

FeldTypPflichtBeschreibung
textText—Der neue Datei-Inhalt; fehlt er, wird die Datei geleert.

anhängenverändernd

Hängt Text an das Ende der Datei an.

Eingaben

FeldTypPflichtBeschreibung
textText—Anzuhängender Text (kann mehrere Zeilen umfassen).

voranstellenverändernd

Stellt Text an den Anfang der Datei.

Eingaben

FeldTypPflichtBeschreibung
textText—Voranzustellender Text (kann mehrere Zeilen umfassen).

zeile-setzenverändernd

Überschreibt eine bestehende Zeile mit neuem Text.

Eingaben

FeldTypPflichtBeschreibung
nummerZahlja1-basierte Zeilennummer der zu ersetzenden Zeile; muss vorhanden sein.
textText—Neuer Inhalt der Zeile; fehlt er, wird die Zeile geleert.

zeile-einfügenverändernd

Fügt eine neue Zeile vor der angegebenen Position ein.

Eingaben

FeldTypPflichtBeschreibung
nummerZahlja1-basierte Position; die neue Zeile rückt davor ein. Anzahl+1 hängt ans Ende an.
textText—Inhalt der neuen Zeile.

zeile-anhängenverändernd

Hängt eine neue Zeile am Ende der Datei an.

Eingaben

FeldTypPflichtBeschreibung
textText—Inhalt der neuen Zeile.

zeile-entfernenverändernd

Löscht eine bestimmte Zeile aus der Datei.

Eingaben

FeldTypPflichtBeschreibung
nummerZahlja1-basierte Zeilennummer der zu löschenden Zeile; muss vorhanden sein.

ersetzenverändernd

Ersetzt Vorkommen eines Such-Texts oder Regex-Musters im gesamten Datei-Inhalt.

Eingaben

FeldTypPflichtBeschreibung
suchenTextjaZu suchender Text oder Regex-Muster; darf nicht leer sein.
ersetzen-durchText—Ersatztext (leer = Treffer löschen). Bei Regex sind Capture-Verweise wie ${1} möglich.
regexWahrheit—Wenn wahr, wird 'suchen' als regulärer Ausdruck ausgewertet. Standard: falsch.
groß-klein-egalWahrheit—Wenn wahr, wird Groß-/Kleinschreibung ignoriert. Standard: falsch.
alleWahrheit—Wenn wahr (Standard), werden alle Vorkommen ersetzt; bei falsch nur das erste.

Ausgaben (über ergebnis:)

anzahlAnzahl der ersetzten Vorkommen als Zahl.

leerenverändernd

Leert den gesamten Datei-Inhalt.

speichernverändernd

Schreibt den aktuellen Inhalt explizit in die Block-Datei zurück.

speichern-unterverändernd

Schreibt den aktuellen Inhalt in eine andere Datei.

Eingaben

FeldTypPflichtBeschreibung
pfadTextjaZiel-Pfad der neuen Datei; darf nicht leer sein.

Beispiele

Logdatei nach Fehlern durchsuchen

Durchsucht eine Logdatei zeilenweise nach dem Wort 'ERROR' (Groß-/Kleinschreibung egal) und liefert alle Treffer mit Zeilennummer.

textdatei
suchen
musterERROR
groß-klein-egalja
treffer (Ausgabe)fehlerzeilen
- textdatei:
    datei: "C:\\Logs\\dienst.log"
    aktionen:
      - suchen:
          muster: "ERROR"
          groß-klein-egal: ja
          ergebnis: fehlerzeilen

Konfiguration anpassen und Zeile ergänzen

Ersetzt in einer Konfigurationsdatei einen Wert und hängt anschließend eine neue Einstellungszeile an.

textdatei
ersetzen
suchendebug=false
ersetzen-durchdebug=true
anzahl (Ausgabe)ersetzt
textdatei
zeile-anhängen
textloglevel=verbose
- textdatei:
    datei: "C:\\App\\config.ini"
    aktionen:
      - ersetzen:
          suchen: "debug=false"
          ersetzen-durch: "debug=true"
          ergebnis: ersetzt
      - zeile-anhängen:
          text: "loglevel=verbose"