Perl 5 version 14.2 documentation


  • push ARRAY,LIST

  • push EXPR,LIST

    Treats ARRAY as a stack by appending the values of LIST to the end of ARRAY. The length of ARRAY increases by the length of LIST. Has the same effect as

    1. for $value (LIST) {
    2. $ARRAY[++$#ARRAY] = $value;
    3. }

    but is more efficient. Returns the number of elements in the array following the completed push.

    Starting with Perl 5.14, push can take a scalar EXPR, which must hold a reference to an unblessed array. The argument will be dereferenced automatically. This aspect of push is considered highly experimental. The exact behaviour may change in a future version of Perl.