# Function Reference

# _ArrayPop

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

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

## Parameters

$aArray | Array to modify

## Return Value

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 - $aArray is not a 1D array 3 - $aArray is empty

## Remarks

If $aArray has one element left, it will be set to "" after _ArrayPop() is used on it.

## Related

_ArrayAdd, _ArrayDelete, _ArrayInsert, _ArrayPush

## Example

    #include <Array.au3>
    #include <MsgBoxConstants.au3>

    Local $avArray[10]

    $avArray[0] = "JPM"
    $avArray[1] = "Holger"
    $avArray[2] = "Jon"
    $avArray[3] = "Larry"
    $avArray[4] = "Jeremy"
    $avArray[5] = "Valik"
    $avArray[6] = "Cyberslug"
    $avArray[7] = "Nutster"
    $avArray[8] = "JdeB"
    $avArray[9] = "Tylo"

    _ArrayDisplay($avArray, "$avArray BEFORE _ArrayPop()")
    While UBound($avArray)
        MsgBox($MB_SYSTEMMODAL, '_ArrayPop() return value', _ArrayPop($avArray))
        _ArrayDisplay($avArray, "$avArray AFTER _ArrayPop()")
    WEnd