###User Defined Function###
_ArrayPop

###Description###
Returns the last element of an array, deleting that element from the array at the same time.

###Syntax###
#include <Array.au3>
_ArrayPop ( ByRef $avArray )


###Parameters###
@@ParamTable@@
$avArray
	Array to modify
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	the last element of the array (see remarks).
Failure:	sets the @error flag to non-zero.
@error:	1 - The Input Must be an array
	2 - $avArray is not a 1 dimensional array
	3 - $avArray is empty
@@End@@


###Remarks###
If $avArray has one element left, it will be set to "" after <a href="_ArrayPop.htm">_ArrayPop()</a> is used on it.


###Related###
_ArrayAdd, _ArrayDelete, _ArrayInsert, _ArrayPush


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