###Function###
FileReadLine

###Description###
Liest eine Zeile Text aus einer zuvor geöffneten Textdatei.

###Syntax###
FileReadLine ( filehandle or "filename" [, line] )


###Parameters###
@@ParamTable@@
filehandle
	Das Handle der Datei, wie es von einem früheren Aufruf von  FileOpen zurückgegeben wurde. Alternativ kannst du einen String mit dem Dateinamen als ersten Parameter verwenden.as the first parameter.
line
	[optional] Die Zeilennummer, die gelesen werden soll. Die erste Zeile einer Textdatei hat die Nummer 1 (und nicht 0).
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Gibt  die Textzeile zurück.
Spezial:	Setzt @error auf -1, wenn das Dateiende erreicht wurde.
Misserfolg:	Setzt @error auf 1, wenn die Datei nicht im read mode (Lesemodus) geöffnet wurde oder ein anderer Fehler aufgetreten ist.
@@End@@


###Remarks###
Gbt t die Textzeile zurück, Zeichen, die eine neue Zeile einleiten (CHR(10) oder @LF), werden am Ende der Zeile automatisch abgeschnitten.
Wenn keine Zeilennummer angegeben wurde, wird die "nächste" Zeile eingelesen (die "nächste" bedeutet bei einer frisch geöffneten Datei die erste Zeile).

Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei wärhrend des Funktionsaufrufes geöffnet und geschlossen. Wenn du große Textdateien bearbeitst, ist das natürlich viel langsamer als die Arbeit mit Handles. Die Datei wird wird erstellt, wenn sie noch nicht existiert.

Hinweis: Vermische nicht die Verwendung von Dateihandles und -namen. Öffne  z.B. nicht eine Datei mit FileOpen und verwende dann in dieser Funktion einen Dateinamen. Benutze entweder Handles oder Dateinamen - nicht beides.

###Related###
IniRead, FileClose, FileOpen, FileRead, FileWrite, FileWriteLine


###Example###
@@IncludeExample@@
