Durchsucht den Text in einer Datei nach Strings, Zahlen, Pfaden und booleschen Daten ab, wandelt den Text in einen bestimmten Datentyp um und gibt eine Kopie der Referenz sowie die konvertierten Daten in der Trefferreihenfolge aus. Die Funktion arbeitet nicht mit Dateien in LLBs.

Mit dieser Funktion kann der gesamte Text in der Datei gelesen werden. Allerdings ist es mit diesem VI nicht möglich, den Ausgangspunkt für einen Suchvorgang festzulegen. Dafür sollten stattdessen die Funktionen Aus Textdatei lesen und In String suchen verwendet werden.


icon

Ein-/Ausgänge

  • cstr.png Format-String —

    Format-String gibt an, wie der Eingangs-String in die auszugebenden Argumente konvertiert wird.

    Standardmäßig wird der String entsprechend dem Standardverhalten der ausgegebenen Datentypen durchsucht. Klicken Sie mit der rechten Maustaste auf die Funktion und wählen Sie die Option Such-String bearbeiten aus dem Kontextmenü, um einen Format-String zu erzeugen oder bearbeiten.

    An diesem Eingang können bis zu 255 Zeichen angegeben werden.

  • cbsrn.png Eingabedatei —

    Eingabedatei kann eine Referenz oder ein absoluter Dateipfad sein.

    Bei einem Dateipfad öffnet die Funktion die durch die Referenz angegebene Datei. Wenn die gewünschte Datei nicht vorhanden ist, erstellt die Funktion eine neue. Standardmäßig wird das Dateidialogfeld angezeigt und Sie werden aufgefordert, eine Datei auszuwählen.

    Bei einem leeren oder relativen Pfad gibt die Funktion einen Fehler aus.

  • cerrcodeclst.png Fehler (Eingang) —

    Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

  • cdbl.png Standardwert 13 —

  • ibsrn.png Datei (Referenz, Ausgang) —

    Ausgabedatei (Referenz) ist eine Referenz auf die Datei, die das VI ausliest.

    Je nachdem, was mit dieser Datei geschehen soll, können Sie diesen Ausgang mit einer anderen Dateifunktion verbinden. Standardmäßig wird die Datei geschlossen, wenn sie durch einen Pfad oder im Dateidialogfeld ausgewählt wird. Ist Eingabedatei eine Referenz, wird davon ausgegangen, dass die Datei noch verwendet wird.
  • ierrcodeclst.png Fehler (Ausgang) —

    Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.

  • idbl.png Ausgang 8 —

    • Parameter werden mit einem Klick mit der rechten Maustaste auf die Funktion und durch Auswahl von Parameter hinzufügen aus dem Kontextmenü oder durch Aufziehen der Funktion mit der Maus hinzugefügt.

    Hinweis Tritt ein Fehler auf, enthält die Quellkomponente des Error-Out-Clusters eine Zeichenkette der Form ''Scan From File (arg n)'', wobei n das erste Argument ist, bei dem der Fehler aufgetreten ist.

    Wenn Sie Format-String im Blockdiagramm mit einer String-Konstante verbinden, dann werden während der Kompilierung mit Hilfe von Format-String die Anzahl der Ausgänge und der Datentyp jedes Ausgangs ermittelt. Wenn die Typen an den Ausgängen nicht mit den unter Format-String angegebenen übereinstimmen, müssen Sie die Typen korrigieren, da sonst das VI nicht funktioniert.

    Wenn Sie keine Blockdiagrammkonstante mit dem Eingang Format-String verbunden haben, wird die Richtigkeit der angeschlossenen Datentypen bei der Ausführung geprüft. Soll nach Werten gesucht werden, die einen anderen Datentyp als "Fließkommazahl mit doppelter Genauigkeit" haben, müssen Sie die entsprechenden Datentypen mit Standard 1..n verbinden.

    Die nicht in den Formatbezeichnern (%[^...]) befindlichen Zeichen werden bis zu den im Formatbezeichner eingetragenen Zeichen aus dem String entfernt. Die gefundenen, im Formatbezeichner enthaltenen Zeichen, bleiben in der Datei erhalten. Auf diese Weise werden wiederholt komplette Strings aus Dateien gelesen. Mit %[^\n\r] wird eine komplette Textzeile aus der Datei gelesen bis zum darauf folgenden Wagenrücklauf (\n) und Zeilenumbruch (\r). Diese Steuerzeichen werden mit %[^\n\r]\n\r entfernt.

    Hinweis Standardmäßig wird das im Gebietsschema des Betriebssystems ausgewählte Dezimalzeichen verwendet. In manchen Fällen, z. B. bei Verwendung von GPIB-Messgeräten auf europäischen Betriebssystemen, muss das Dezimalzeichen unter Umständen durch Lokalisierungscodes geändert werden.

    Beispiele zur Formatierung von Strings

    Eingangs-StringFormat-StringStandard(s)Ausgabe(n)Verbleibender String

    abc, xyz

    >12.3+56i 7200

    		%3s, %s%f%2d—abc00
    —xyz
    0+00i12,3+56i
    —72
    Q+1,27E–3 tailQ%f t—1,27E–3ail
    0123456789%3d%3d—126789
    345
    X:9,860 Z:3,450X:%fY:%f100 (I32)10Z: 3450
    100,00 (DBL)100,00
    set49.4.2set%d—49.4.2
    Farbe: RotFarbe: %sBlau (Enum {Rot, Grün, Blau})rot—
    abcd012xyz3

    %[a-z]%d

    %[a-z]%d

    		—abcd—
    12
    xyz
    3
    Willkommen bei LabVIEW, Hans Schmidt%[^,],%s—Willkommen bei LabVIEWSchmidt
    Manfred

    Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\File IO\Text (ASCII)\Format Into File and Scan From File.vi