###User Defined Function###
_ArrayDelete

###Description###
Deletes the specified element from the given array.

###Syntax###
#include <Array.au3>
_ArrayDelete ( ByRef $avArray, $iElement )


###Parameters###
@@ParamTable@@
$avArray
	Array to modify
$iElement
	Element to delete
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	the new size of the array (see remarks)
Failure:	-1 and sets the @error flag to non-zero.
@error:	1 - $avArray is not an array
	3 - $avArray has too many dimensions (only up to 2D supported)
@@End@@


###Remarks###
If the array has one element left (or one row for 2D arrays), it will be set to "" after <a href="_ArrayDelete.htm">_ArrayDelete()</a> is used on it.

If the $iElement is greater than the array size then the last element is destroyed.


###Related###
_ArrayAdd, _ArrayInsert, _ArrayPop, _ArrayPush


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