file_str_read

file_str_read (var handle,STRING* string)

file_str_readto(var handle, STRING* string, char *delimiter, var length)

Liest Inhalt aus der Datei mit dem gegebenen Handle in den gegebenen String oder Buffer bis eine Größe oder eine Grenzbezeichnung erreicht ist. Auf diese Weise lassen sich mit Kommata getrennnte Strings aus einer database-Datei lesen. Um gelesen werden zu können, muss die Datei geöffnet sein.

Parameter:

handle - Datei-Handle
string - STRING* oder A7.79 char*-Pointer zum Erhalt des Leseinhaltes oder .A7.20 NULL, um den Inhalt der Datei zu überspringen.
delimiter - STRING* oder char*, wird als Endmarke für den Text benutzt oder NULL das Verwenden des delimit_str oder "" (leerer String) für keine Endmarke.
length - Maximale Anzahl der zu lesenden Zeichen (1..4000 zum Einlesen in einen STRING*, 1..999999 zum Einlesen in einen char*-Buffer der gegebenen Größe).

Rückgabewerte:

Anzahl der gelesenen Zeichen oder -1 wenn das Ende der Datei erreicht ist.

Bemerkungen:

Zum Lesen muss die Datei geöffnet sein.
Die Grenzbezeichnung für file_str_read ist entweder ein '0'-Byte in der Datei, irgendein Kontrollzeichen (beispielsweise ein Zeilenvorschub) oder besteht aus dem Inhalt der Variablen delimit_str (default: Komma ','). Die Grenzbezeichnung für file_str_readto ist entweder ein '0'-Byte in der Datei oder der delimiter-Parameter wenn er ungleich Null war.
Die maximal lesbare Stringgrösse besteht aus 4000 Zeichen. Diese Begrenzung gilt nicht beim Lesen in einen char*-Buffer.

Beispiel:

STRING* sTest = "     ";
...
fhandle = file_open_read("test.txt"); // test.txt contains "this,is,a,test"
file_str_read(fhandle,sTest); // sTest now contains "this"
file_close(fhandle);

Siehe auch:

file_open_read, file_close, file_var_read, file_str_write, file_chr_read, file_asc_write, file_asc_read, txt_load, delimit_str

► Aktuelle Version Online