WRITESTRING Stream, Text$


Beschreibung
Dieser Dateibefehl schreibt einen "Datensatz" in eine mit OPENFILE/READFILE geöffnete Datei.

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. Dieser Befehl kann nur in Verbindung mit READSTRING 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 in eine Datei gespeichert werden können.

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

Nach dem Schreiben wird die Dateiposition automatisch verschoben. Benutze SEEKFILE, um die Dateiposition manuell zu ändern. Der nächste Schreibvorgang wird ab dieser Position erfolgen.


Parameter
Stream=Dateiidentität, die mit OPENFILE/WRITEFILE ermittelt wurde
Text=Beliebiger Text, der abgespeichert werden soll


Rückgabewert
-


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
WRITEBYTE, WRITEBYTES, WRITEFLOAT, WRITEINT, WRITELINE, WRITESHORT