###User Defined Function###
_ArrayPermute

###Description###
Returns an array of the Permutations of all Elements in a 1-dimensional array

###Syntax###
#include <Array.au3>
_ArrayPermute ( ByRef $aArray [, $sDelimiter = ""] )


###Parameters###
@@ParamTable@@
$aArray
	The Array to get Permutations
$sDelimiter
	[optional] String result separator, default is "" for none
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	an array of Permutations.
	$aArray[0] contains the number of strings returned.
	The remaining elements ($aArray[1], $aArray[2] ... $aArray[n]) contain the Permutations.
Failure:	sets the @error flag to non-zero.
@error:	1 - The Input Must be an Array
	2 - $aArray is not a 1 dimensional array
@@End@@


###Remarks###
The input array must be 0-based, i.e. no counter in $aArray[0].
Based on the algorithm by Alexander Bogomolny (<a href="http://www.bearcave.com/random_hacks/permute.html">http://www.bearcave.com/random_hacks/permute.html</a>).


###Related###
_ArrayCombinations


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