Text$=READSTRING$ (Stream)


Beschreibung
Diese Dateifunktion liest einen "Datensatz" aus einer mit OPENFILE/READFILE geöffneten Datei aus.

Jeder Datensatz muss eine Integer-Kennung (=4 Byte) haben, die die Länge des Textes in Zeichen angibt. Diese Kennung wird vor jedem Text gespeichert. Danach folgt ein String mit dieser Länge. Diese Funktion kann nicht auf eine einfache Textdatei angewendet werden, sondern kann nur in Verbindung mit WRITESTRING benutzt werden.

Die Return-Zeichen (0Dh), LineFeed-Zeichen (0Ah) oder Null-Zeichen (00h) haben keine Auswirkung auf die Textlänge!
Hinweis: Die Längenkennzeichnung wird nur in der Datei gespeichert, nicht im String.

Die folgende Tabelle zeigt verschiedene Typen von Werten, die aus einer Datei ausgelesen werden können.

NameBytes  TypeMin.Max.
Byte1Ganzzahl0+255
Short2Ganzzahl-32768+32767
Integer  4Ganzzahl-2147483648  +2147483647
Float4Kommazahl  -2 Mrd.+2 Mrd.
Lineanz+2String--
Stringanz+4String--

Benutze EOF, um zu prüfen, ob das Ende einer Datei erreicht ist. Falls Daten außerhalb der Dateilänge ausgelesen werden, so kommt es nicht zu einem Fehler, aber die zurückgelieferten Strings enthalten keine Zeichen.

Die Datei muss bereits existieren, da sonst eine Fehlermeldung nach einem Lesevorgang erscheint. Benutze vorher den Befehl FILETYPE.


Parameter
Stream = Dateiidentität, die mit OPENFILE/READFILE ermittelt wurde


Rückgabewert
Ein String mit unterschiedlich vielen Zeichen.


Beispiel
Dieses Programm speichert den Text "Hallo" in eine Datei. Danach wird es wieder ausgelesen und ausgegeben:

fileout = WRITEFILE("mydata.dat")
WRITESTRING fileout,"Hallo"
CLOSEFILE fileout
filein = READFILE("mydata.dat")
Wert$ = READSTRING$(filein)
CLOSEFILE filein
PRINT Wert$


Siehe auch
READBYTE, READBYTES, READFLOAT, READINT, READLINE, READSHORT