###User Defined Function###
_FileWriteFromArray

###Description###
Writes an array to a specified file

###Syntax###
#include <File.au3>
_FileWriteFromArray ( $sFilePath, Const ByRef $aArray [, $iBase = Default [, $iUBound = Default [, $sDelimiter = "|"]]] )


###Parameters###
@@ParamTable@@
$sFilePath
	Path of the file to write to, or a file handle returned by <a href="../functions/FileOpen.htm">FileOpen()</a>.
$aArray
	The array to be written to the specified file.
$iBase
	[optional] Start array index to read, normally set to 0 or 1. Default is the Default keyword.
$iUbound
	[optional] Set to the last record you want to write to the File. Default is the Default keyword (whole array.)
$sDelimiter
	[optional] Delimiter character(s) for 2-dimension arrays. Default is "|".
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	1.
Failure:	0 and sets the @error flag to non-zero.
@error:	1 - Error opening specified file
	2 - $aArray is not an array
	3 - Error writing to file
	4 - $aArray is not a 1D or 2D array
	5 - Start index is greater than the $iUbound parameter
@@End@@


###Remarks###
If a string path is provided, the file is overwritten and closed.
To use other write modes, like append or Unicode formats, open the file with <a href="../functions/FileOpen.htm">FileOpen()</a> first and pass the file handle instead.
If a file handle is passed, the file will still be open after writing.


###Related###
_FileReadToArray


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