###Function###
FileWrite

###Description###
Append a line of text to the end of a previously opened text file.

###Syntax###
FileWrite ( filehandle or "filename", "line" )


###Parameters###
@@ParamTable@@
filehandle
	The handle of a file, as returned by a previous call to FileOpen.  Alternatively, you may use a string filename as the first parameter.
line
	The line of text to write to the text file.  The line is written as is - no @CR or @LF characters are added.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if file not opened in writemode, file is read only, or file cannot otherwise be written to.
@@End@@


###Remarks###
The text file must be opened in write mode or the FileWrite command will fail.

If a filename is given rather than a file handle, the file will be opened and closed during the function call.  For parsing large text files this will be much slower than using filehandles.  However, filename will be created if it does not already exist.

Note: Do not mix filehandles and filenames, i.e., don't FileOpen a file and then use a filename in this function. Either use filehandles or filenames in your routines, not both.

If the line is a BinaryString it will be written to the file allowing to write null chars.


###Related###
FileClose, FileOpen, FileRead, FileReadLine, FileWriteLine, BinaryString


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