You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit 135abefda8f01c71feb2d24e5415f1d62b2a235a)
push ARRAY,LIST

Adds one or more items to the end of an array.

my @animals = ("cat");
push(@animals, "mouse"); # ("cat", "mouse")

my @colors = ("red");
push(@colors, ("blue", "green")); # ("red", "blue", "green")

Returns the number of elements in the array following the completed push.

my $color_count = push(@colors, ("yellow", "purple"));

say "There are $color_count colors in the updated array";

Starting with Perl 5.14, an experimental feature allowed push to take a scalar expression. This experiment has been deemed unsuccessful, and was removed as of Perl 5.24.