f$DateiLesen (f$FileRead)

Lesen eines Wertes aus einer zuvor zum Lesen geöffneten Datei.

Gelesen wird dabei von der aktuellen Position in der Datei bis zu einem übergebenen Trennzeichen. Soll eine ganze Dateizeile gelesen werden, so kann als Trenner ein Leertext (’’) übergeben werden. Wird das Trennzeichen in der aktuellen Dateizeile nicht gefunden, so wird der Rest bzw. die gesamte Dateizeile zurückgegeben (Das Zeilenende ist immer ein Trennzeichen!).

Der gelesene Wert kann evtl. - je nach Dateiformat - abschließende Leerzeichen enthalten. Diese können z.B. über die ePOS Zusatzfunktion p$TDV:Allg:StrTrunc entfernt werden.

Der Feldinhalt wird als Rückgabe dem entsprechenden Parameter zugewiesen.

Syntax:	DateiText = f$DateiLesen( DateiNr, Trenner )
	Argument	Typ	Bedeutung
	DateiNr	Ganzzahl	Dateinummer
	Trenner	Zeichenkette	Trennzeichen für einzelne Dateiwerte, z.B. ein „;". Lesen der gesamten Zeile mit ''.
Ergebnis:	Zeichenkette	gelesener Text aus der Datei
Beispiel:	Die nächste Zeile einer Datei sei die folgende: "Muster ;Herbert" Dann ergeben die folgenden Funktionsaufrufe: Text = f$DateiLesen( DateiNr, ';' ) → Text = 'Muster ' Text = f$DateiLesen( DateiNr, '' ) → Text = 'Muster ;Herbert' Text = f$DateiLesen( DateiNr, '%' ) → Text = 'Muster ;Herbert'