Liest eine festgelegte Anzahl von Zeichen oder Zeilen aus einer Bytestream-Datei. Die Funktion arbeitet nicht mit Dateien in LLBs.


icon

Ein-/Ausgänge

  • cstr.png Eingabeaufforderung (vorhandene Datei öffnen) —

    Eingabeaufforderung ist die Meldung, die über der Liste der Dateien und Verzeichnisse im Dateidialogfeld erscheint.

  • cpath.png Datei (Dialog verwenden) —

    Datei kann eine Referenz oder ein absoluter Dateipfad sein.

    Bei einem Dateipfad öffnet die Funktion die durch den Pfad angegebene Datei. Standardmäßig wird das Dateidialogfeld angezeigt und Sie werden aufgefordert, eine Datei auszuwählen.

    Wenn Sie einen leeren oder relativen Pfad angeben oder die Datei nicht existiert, gibt die Funktion einen Fehler aus.

  • ci32.png Anzahl —

    Anzahl ist die maximale Anzahl an Zeichen oder Zeilen, die von der Funktion gelesen werden sollen.

    Die Funktion liest weniger Zeichen oder Zeilen, wenn vorher das Ende der Datei erreicht wird. Wenn Anzahl <0 ist, liest die Funktion die gesamte Datei beginnend bei der aktuellen Dateiposition aus. Per Voreinstellung wird eine Zeile ausgelesen, wenn Sie den Kontextmenüpunkt Zeilen lesen ausgewählt haben. Anderenfalls wird die gesamte Datei gelesen.
    Hinweis Wenn Sie eine Datei mit Anzahl verbinden, die einen anderen als den 32-Bit-Integer-Datentyp hat, passt LabVIEW den Typ entsprechend an. Das heißt, dass das VI unter Umständen nicht die gewünschte Datenmenge liest. Wenn Sie –1 mit Anzahl verbinden und die zu lesende Datei nicht mit einem 32-Bit-Integer dargestellt werden kann, gibt LabVIEW 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.

  • ibsrn.png Referenz (Ausgang) —

    Referenz (Ausgang) ist die Referenz auf die Datei, die von der Funktion ausgelesen wird. 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. Wenn Datei eine Referenz ist oder Referenz (Ausgang) mit einer anderen Funktion verbunden wird, geht LabVIEW davon aus, dass die Datei bis zum Schließen in Verwendung ist.

  • istr.png Text —

    Text ist der aus der Datei gelesene Text. Standardmäßig ist dieser Parameter ein String mit den aus der ersten Zeile der Datei gelesenen Zeichen. Wenn Sie Anzahl mit einem Wert verbinden, wird ein String-Array mit den aus der Datei gelesenen Zeilen ausgegeben. Wenn Sie mit der rechten Maustaste auf die Funktion klicken und die Option Zeilen lesen deaktivieren, wird aus diesem Parameter ein String mit den aus der Datei gelesenen Zeilen.

  • ibool.png Abgebrochen —

    Abgebrochen ist beim Abbrechen des Dateidialogfelds TRUE.

    Anderenfalls ist Abgebrochen FALSE, auch wenn diese Funktion einen Fehler ausgibt.
  • ierrcodeclst.png Fehler (Ausgang) —

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

    • Diese Funktion öffnet Dateien im schreibgeschützten Modus. Wenn Sie den Ausgang Referenz (Ausgang) dieser Funktion mit dem Eingang Datei einer Schreibfunktion verbinden, wird ein Berechtigungsfehler angezeigt. Öffnen Sie die Datei mit der Funktion Öffnen/Erstellen/Ersetzen einer Datei mit den Standardberechtigungen für Schreib- und Lesezugriff und verbinden Sie die Referenz mit der Schreib- und der Lesefunktion.

    Per Voreinstellung liest diese Funktion alle Zeichen aus der Textdatei. Verbinden Sie Anzahl mit einer ganzen Zahl, um festzulegen, wie viele einzelne Zeichen beginnend bei dem ersten Zeichen gelesen werden sollen. Klicken Sie mit der rechten Maustaste auf die Funktion und aktivieren Sie die Option Zeilen lesen, damit einzelne Zeilen aus der Textdatei gelesen werden. Wenn Sie im Kontextmenü die Option Zeilen lesen auswählen, verbinden Sie den Eingang Anzahl mit einer ganzen Zahl, um festzulegen, wie viele Zeilen beginnend bei der ersten aus der Datei gelesen werden sollen. Bei -1 für Anzahl werden alle Zeilen aus der Datei gelesen.

    Für beliebigen Zugriff auf eine Datei muss die Funktion Dateiposition festlegen verwendet werden.

    Diese Funktion konvertiert alle plattformabhängigen Zeilenendzeichen in Zeilenvorschübe, es sei denn, Sie klicken die Funktion mit der rechten Maustaste an und deaktivieren die Option EOL konvertieren im Kontextmenü. Bei einer Pfadangabe unter Datei wird die Datei vor dem Lesevorgang geöffnet und anschließend wieder geschlossen.

    Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\File IO\Text (ASCII)\Write to Text File and Read from Text File.vi