FReadStr(): Unterschied zwischen den Versionen
Georg (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „ == Allgemeines == Die Funktion fReadStr() dient dazu, aus einer mittels fOpen() geöffneten, bzw. durch fCreate() erzeugten Datei eine Zeichenkette z…“) |
Georg (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
| Zeile 15: | Zeile 15: | ||
== Parameter == | == Parameter == | ||
<nHandle> ist der Datei-Handle, der von einem erfolgreichen [[fOpen()]]- bzw. [[fCreate()]]-Aufruf zurückgegeben wird. | |||
<nBytes> gibt die maximale Anzahl Zeichen an, die aus der Datei gelesen werden sollen. | |||
| Zeile 20: | Zeile 24: | ||
== Rückgabewert == | == Rückgabewert == | ||
cString => Zeichenstring entsprechend der Anforderung. Im Falle eines Dateifehlers, oder wenn das Ende der Datei erreicht wurde, wird ein Leerstring ("") zurückgegeben. | |||
| Zeile 26: | Zeile 32: | ||
== Besonderheiten == | == Besonderheiten == | ||
Wenn fReadStr() auf ein [[Chr(0)|Chr()]] trifft, endet der Leseprozess. | |||
Im Gegensatz zu [[fRead()]] liefert fReadStr() eine Zeichenvariable zurück, während für [[fRead()]] die Zeichenvariable vor dem Aufruf initialisiert sein muss. | |||
| Zeile 31: | Zeile 40: | ||
== Querverweise == | == Querverweise == | ||
[[fRead()]] | |||
Aktuelle Version vom 9. Januar 2017, 12:34 Uhr
Allgemeines
Die Funktion fReadStr() dient dazu, aus einer mittels fOpen() geöffneten, bzw. durch fCreate() erzeugten Datei eine Zeichenkette zu lesen.
Entsprechend dem Aufruf liefert die Funktion entweder eine vorgegebene Anzahl Zeichen, oder bis in der Zeichenkette ein Chro(0) auftritt.
Syntax
fReadStr(<nHandle>, <nBytes>) => cString
Parameter
<nHandle> ist der Datei-Handle, der von einem erfolgreichen fOpen()- bzw. fCreate()-Aufruf zurückgegeben wird.
<nBytes> gibt die maximale Anzahl Zeichen an, die aus der Datei gelesen werden sollen.
Rückgabewert
cString => Zeichenstring entsprechend der Anforderung. Im Falle eines Dateifehlers, oder wenn das Ende der Datei erreicht wurde, wird ein Leerstring ("") zurückgegeben.
Besonderheiten
Wenn fReadStr() auf ein Chr() trifft, endet der Leseprozess.
Im Gegensatz zu fRead() liefert fReadStr() eine Zeichenvariable zurück, während für fRead() die Zeichenvariable vor dem Aufruf initialisiert sein muss.
Querverweise
benötigte DLLs bzw. Include-Dateien
XppRT1.dll