Liest beginnend an der angegebenen Stelle eine festgelegte Anzahl von Zeilen aus einer numerischen Textdatei und wandelt die Daten in ein 2D-Array aus Strings, ganzen Zahlen oder Fließkommazahlen doppelter Genauigkeit um. Die zu verwendende polymorphe Instanz wird manuell ausgewählt.

Bei Bedarf kann das Array auch transponiert werden. Die Datei wird vor dem Lesevorgang geöffnet und anschließend wieder geschlossen. Mit diesem VI können auch im Textformat gespeicherte Tabellenkalkulationsdateien ausgelesen werden. Zur Umwandlung der Daten ruft das VI die Funktion Tabellen-String nach Array auf.


icon

Ein-/Ausgänge

  • cstr.png Format (%d) —

    Format gibt an, wie die Zahlen in Zeichen umgewandelt werden sollen.

    Beim Format %d (Standard) werden die Daten in Ganzzahlen umgewandelt, wobei so viele Zeichen wie notwendig einbezogen werden. Wenn das Format %.3f lautet, erstellt das VI einen String, der Zahlen mit drei Stellen nach dem Komma enthalten kann. Wenn Format auf %s eingestellt ist, kopiert das VI den Eingangs-String. Beachten Sie jedoch die Format-String-Syntax.

  • cpath.png Dateipfad (Dialog, wenn leer) —

    Dateipfad ist der Pfad zur Datei. Wenn der Dateipfad leer ist (Standard) oder <Kein Pfad> lautet, zeigt das VI ein Dialogfeld an, über das Sie eine Datei auswählen können. Beim Abbrechen des Dialogfelds wird der Fehler 43 ausgegeben.

  • ci32.png Zeilenanzahl (alle:-1) —

    Zeilenanzahl ist die maximale Anzahl der Zeilen, die gelesen werden sollen.

    Zeichenfolgen werden als Zeile interpretiert, wenn entweder die maximale Zeichenanzahl pro Zeile, ein Wagenrücklauf, Zeilenvorschub, Wagenrücklauf gefolgt von einem Zeilenvorschub oder das Dateiende erreicht wird. Bei einer Zeilenanzahl kleiner als 0 wird die gesamte Datei ausgelesen. Der Standardwert lautet –1.

  • ci32.png Position der Lesemarke (Zeichen: 0) —

    Position der Lesemarke ist die Stelle in der Datei (in Zeichen oder Bytes), an der der Lesevorgang beginnen soll.

    Da Bytestream-Dateien verschiedene Datentypen enthalten können, wird die Position statt als Zahlenwert in Bytes angegeben. Zum Lesen eines Arrays mit 100 Zahlenwerten, das einem Header von 57 Zeichen folgt, wäre Position der Lesemarke beispielsweise auf 57 zu setzen.

  • ci32.png Max. Zeichen pro Zeile (keine Begrenzung:0) —

    Max. Zeichen pro Zeile ist die Anzahl an Zeichen, die maximal gelesen werden sollen, bis das Ende einer Zeile erreicht wird.

    Die Standardeinstellung lautet 0. Das bedeutet, dass es keine Begrenzung für die Anzahl der Zeichen gibt.

  • cerrcodeclst.png Fehler (Eingang, kein Fehler) —

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

  • cbool.png Transponieren? (F) —

    Transponieren? gibt an, ob das VI die Daten nach der Umwandlung aus einem String transponiert.

    Die Standardeinstellung lautet FALSE.

  • cstr.png Trennzeichen (\t) —

    Trennzeichen ist das Zeichen oder der String aus Zeichen, mit dem die Felder in der Tabellenkalkulationsdatei voneinander getrennt werden. So gilt bei der Einstellung "Komma" (,) beispielsweise ein Komma als Trennzeichen. Die Standardeinstellung lautet \t, das heißt, das Trennzeichen ist ein Tabulatorzeichen.

  • ipath.png Neuer Dateipfad (kein Pfad, wenn abgebrochen) —

    Neuer Dateipfad gibt den Pfad zur Datei aus.

  • i2di64.png Alle Zeilen —

    Alle Zeilen sind die Daten, die aus der Datei gelesen werden.

  • i1di64.png Erste Zeile —

    Erste Zeile ist die erste Zeile des Arrays Alle Zeilen.

    Sie können diesen Ausgang verwenden, wenn Sie nur eine Zeile in ein 1D-Array einlesen möchten.

  • ii32.png Dateimarke nach Lesevorgang (Zeichen) —

    Dateimarke nach Lesevorgang zeigt immer auf das Zeichen oder Byte nach dem zuletzt gelesenen.

  • ierrcodeclst.png Fehler (Ausgang) —

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

  • ibool.png EOF? —

    EOF? wechselt beim Überschreiten des Dateiendes auf TRUE.