###Function###
FileWrite

###Description###
Hängt eine Zeile Text an das Ende einer zuvor geöffneten Datei an.

###Syntax###
FileWrite ( 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.
line
	Die Textzeile, die in die Datei geschrieben werden soll. Die zeile wird so wie sie ist in die Datei geschrieben. Es wird kein @CR oder @LF angehängt.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Gibt 1 zurück.
Misserfolg:	Gibt 0 zurück, wenn die Datei nicht im writemode geöffnet ist, die Datei schreibgeschützt ist oder aus anderen Gründen nicht in sie geschrieben werden konnte.
@@End@@


###Remarks###
Die Textdatei muss im writemode (Schreibmodus) geöffnet sein, damit FileWriteLine keinen Fehler hervorruft.

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###
FileClose, FileOpen, FileRead, FileReadLine, FileWriteLine


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