@ReadOSFile

Liest aus dem OSFILE mit dem FILEHANDLE FILEHANDLE1 einen Satz mit der Länge FN LENGTH3. Dieser Satz wird als Variable des Datentyp’s, der in TEXT RETTYPE2 spezifiziert wird, zurückgegeben.
Wird TEXT/TEXTLIST TEXT3/TEXTLIST3 angegeben, wird bis zum Auftreten des ersten Trennzeichenstrings (TEXT3/TEXTLIST3) gelesen.
Es wird der gelesene String ohne den auslösenden Trennzeichenstring zurückgegeben. Beim nächsten Aufruf von @ReadOSFile wird ab dem Zeichen hinter dem auslösenden Trennzeichenstring gelesen.
Wird @ReadOSFile mit dem Parameter NUMBER STATUS4 aufgerufen, wird in diesem der aktuelle Lesestatus zurückgegeben:

0=OK
1=End of file
2=Error

Fehlt STATUS4, so wird das Erreichen des Dateiendes bei einem Leseversuch mit @ERROR END OF FILE beantwortet, sobald kein Byte mehr eingelesen werden konnte. Diese Fehlermeldung aber wird nicht zurückgegeben, wenn STATUS4 angegeben wird!

RETTYPE2:
A=TEXT
B=BINARY (derzeit als RICHTEXT)
N=NUMBER
F=FLOAT
L=FLOAT (konvertierter long)
D=FLOAT (konvertiertes DWORD)
T=TIMEDATE

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;LENGTH3)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";20));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest 20 Zeichen Text ein, gibt ihn aus und schließt sie anschließend wieder.

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;TEXT3)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";"*"));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest bis zum ersten "*"-Zeichen den Text aus dem File ein, gibt ihn aus und schließt sie anschließend wieder.

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;TEXTLIST3)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";"*":@Newline));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest bis zum ersten "*"-Zeichen bzw. @Newline den Text aus dem File ein, gibt ihn aus und schließt sie anschließend wieder.

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;LENGTH3;STATUS4)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";20;Status));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest 20 Zeichen Text ein, gibt ihn aus und schließt sie anschließend wieder.
Status enthält den aktuellen Lese-Status.

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;TEXT3;STATUS4)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";"*"));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest bis zum ersten "*"-Zeichen den Text aus dem File ein, gibt ihn aus und schließt sie anschließend wieder.
Status enthält den aktuellen Lese-Status.

Beispiel: @ReadOSFile(FILEHANDLE1;RETTYPE2;TEXTLIST3;STATUS4)

FILEHANDLE1:=@OpenOSFile("C:\\TEST.TXT";"RT");
@LogReport(@ReadOSFile(FILEHANDLE1;"A";"*":@Newline));
FILEHANDLE1:=@CloseOSFile(FILEHANDLE1);

Öffnet die Datei "C:\\TEST.TXT", liest bis zum ersten "*"-Zeichen bzw. @Newline den Text aus dem File ein, gibt ihn aus und schließt sie anschließend wieder.
Status enthält den aktuellen Lese-Status.