ReadBinaryFile (FPScript)
Liest eine Datenreihe aus einer Binärdatei ein.
Syntax
ReadBinaryFile(File, Start, NumberOfBlocks, BlockSize, Skip, DataType)
Die Syntax der ReadBinaryFile-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
File |
Zeichenkette mit dem Pfad der einzulesenden Binärdatei. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette (Dateiname). Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||||||||
Start |
Die Anzahl der Bytes, die am Dateianfang übersprungen werden sollen. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||||||||
NumberOfBlocks |
Die Anzahl der zu konvertierenden Blöcke. Wenn Null übergeben wird, werden alle Blöcke bis zum Dateiende konvertiert. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||||||||
BlockSize |
Die Anzahl der Werte pro Block. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||||||||
Skip |
Die Anzahl der Bytes, die zwischen den Blöcken übersprungen werden soll. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||||||||
DataType |
Der Datentyp, in dem die Werte vorliegen. Das Argument DataType kann folgende Werte haben:
Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl und 32-Bit Ganzzahl. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Das Ergebnis hat immer die Datenstruktur Datenreihe.
Die Funktion liest ab einer bestimmten Position eine Folge von zusammenhängenden Blöcken ein, zwischen denen eine Lücke konstanter Größe bestehen kann.
Das Ergebnis ist eine Datenreihe, deren Datentyp dem der einzulesenden Werte entspricht. Ausnahmen bilden die folgenden Formate, welche in einer höheren Auflösung ausgegeben werden müssen:
Datentyp |
Wird importiert als |
---|---|
TYPE_INTEGER8 |
16-Bit Ganzzahlen. |
TYPE_INTEGER8 + BIN_UNSIGNED |
16-Bit Ganzzahlen. |
TYPE_INTEGER16 + BIN_UNSIGNED |
32-Bit Ganzzahlen. |
TYPE_INTEGER32 + BIN_UNSIGNED |
64-Bit Ganzzahlen. |
TYPE_REAL48 |
64-Bit Fließkommazahlen. |
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
ReadBinaryFile("c:\\examples\\file.bin", 10, 0, 16, 4, TYPE_FLOATINGPOINT32) |
Die Binärdatei c:\examples\file.bin wird eingelesen, wobei die ersten 10 Byte übersprungen werden. Die Datei wird bis zum Ende gelesen. Es werden 16 Werte pro Block gelesen, wobei zwischen den Blöcken 4 Byte Platz ist. Die Daten liegen im 32-Bit Fließkomma-Format vor. |